概要
方法
属性
方法
DeserializeInstancesAsync
Instances
解析含有 buffer 内容的 .rbxm 文本,返回一个列表 instances。
此 API 只能从工作室插件或开放云 Luau 执行会话中调用。如果包含非可创建实例或服务,将抛出错误。
没有稳定合约为 .rbxm 格式提供,数据的组成可以随时更改。此 API 将忠实地解析 Roblox 引擎编译的 .rbxm 内容,包括 Studio 生成的 .rbxm 文件或通过 SerializeInstancesAsync() 生成的文件。
虽然可以使用此 API 来解析.rbxm由任何其他方式生成的内容,但这在用户自己的风险下进行。引擎可能无法可靠地解析此内容,或根全部无法解析。
参数
默认值:""
返回
Instances
代码示例
SerializationService:SerializeInstancesAsync
local SerializationService = game:GetService("SerializationService")
local part = Instance.new("Part")
part.Name = "MyPart"
local contentBuffer: buffer = SerializationService:SerializeInstancesAsync({part})
local instances: {Instance} = SerializationService:DeserializeInstancesAsync(contentBuffer)
print(instances) -- {MyPart}
SerializeInstancesAsync
将列表 instances 序列化为 .rbxm 格式,返回 buffer 或 .rbxm 内容。
此 API 只能从工作室插件或开放云 Luau 执行会话中调用。如果非创建实例或服务包含在实例列表中,将抛出错误。
没有稳定合约为 .rbxm 格式提供,数据的组成可以随时更改。此 API 将根据当前引擎版本的序列化行为来序列化内容。
虽然其他工具可以解析 .rbxm 内容,但这在用户自己的风险下进行。引擎仍然可能生成 .rbxm 内容,这是第三方工具无法忠实解析的。
参数
inputInstances: Instances
默认值:""
返回
代码示例
SerializationService:SerializeInstancesAsync
local SerializationService = game:GetService("SerializationService")
local part = Instance.new("Part")
part.Name = "MyPart"
local contentBuffer: buffer = SerializationService:SerializeInstancesAsync({part})
local instances: {Instance} = SerializationService:DeserializeInstancesAsync(contentBuffer)
print(instances) -- {MyPart}