概要
方法
屬性
方法
DeserializeInstancesAsync
Instances
解碼包含 buffer 內容的 .rbxm 文件,返回一個列表 instances 。
此 API 只能從工作室插件或開放雲 Luau 執行會話中呼叫。如果包含不可創建的實例或服務在內容中,就會發生錯誤。
對於 .rbxm 格式沒有穩定合約提供,數據的組成可能隨時變化。此 API 將忠實地解析 Roblox 引擎所serialize的 內容,包括 Studio 或通過 生成的文件。
雖然可以使用此 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 會依照目前引擎版本的 serialization 行為來序列化內容。
雖然其他工具可以解析 .rbxm 內容,但這在使用者自己的風險下進行。引擎仍然可能生成 3rd-party 工具無法準確解析的內容 .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}