使用內在體驗資產創建功能,您可以允許您的用戶在體驗中創作的作品儲存在他們的道具欄中。您的用戶可以使用這些內在體驗的作品與任何其他素材一樣使用。此外,這些作品會在 Roblox 平台上顯示時,對您的體驗進行屬性,讓任何用戶都可以來到您的體驗並創作自擁有
舉例來說,您可以讓用戶在您的體驗中創建自訂動物作為寵物,並允許他們將最愛的寵物儲存在他們的道具欄中。 您擁有完全的控制來指定用戶可以從您的體驗中修改和儲存哪些對象。 用戶可以在他們的個人資料中顯示自己的創作,並且對其儲存進行屬性的儲存,提升對您的體�
支援的資產類型和限制
與平台上的所有資產一樣,在體驗中創作的內容受到 資產審核 。目前,您只能允許用戶在您的體驗中創作 包裹 。這些包裹不能包含任何指令碼或私人資產,例如音訊頻、視頻和樹狀包��
當您正在執行或測試您的體驗,並且添加指定的指令碼或私人資產作為體驗內創作品的一部分時,它無法儲存並提示錯誤訊息到 Studio 輸出窗口 或 開發者控制器 。
啟用體驗內容創作
要啟用您的用戶體驗內容創建功能,請在伺服器端的指令碼中使用 AssetService:PromptCreateAssetAsync() API 方法,以及其他創建規則。指定您要啟用此功能的體驗實例,設定一個自訂提示(例如 UI 圖示)以啟動方法,並列聽客戶端遠端事件以儲存資產。
AssetService:PromptCreateAssetAsync() 接受以下參數:
- 一個 Player 對象代表用戶提交資產作品。
- 一個 Instance 對象代表資產以便創作品。
- 枚數.資產類型,目前為 Enum.AssetType.Model 的限制。
當服務器呼叫 AssetService:PromptCreateAssetAsync() 時,會提示客戶端上的 提交包裹 對話框,因此啟動儲存操作的用戶可以輸入包裹的名稱和描述。 Roblox 提供對話框 UI 預製,因為儲存工作流程是平台級功能。
下列服務器端指令提示用戶儲存在體驗中繪畫的車輛:
無經驗人創作資產示例指令碼
-- 定義資產服務變數
local AssetService = game:GetService("AssetService")
-- 設定 PromptCreateAssetAsync() 以提示提交對話框
local function CreateAsset(player, instance)
local complete, result, assetId = pcall(function()
return AssetService:PromptCreateAssetAsync(player, instance, Enum.AssetType.Model)
end)
if complete then
if result == Enum.PromptCreateAssetResult.Success then
print("successfully uploaded, AssetId:", assetId)
else
print("Received result", result)
end
else
print("error")
print(result)
end
end
-- 車輛塗料論理已省略
-- 添加事件處理器
local function onUserPublish(player, promptObject)
-- 使用者以體驗預設顏色儲存車輛實例
if promptObject.Name == "car" then
CreateAsset(player, car)
elseif promptObject.Name == "CarPaintYellow" or promptObject.Name == "CarPaintBlue" or promptObject.Name == "CarPaintBlack" or promptObject.Name == "CarPaintRed" then
PaintCarColor(promptObject.Name)
end
end
PublishEvent.OnServerEvent:Connect(onUserPublish)
體驗內建模擬演示競技場 展示您如何使用此功能的示例。您可以加入挑戰,以體驗內建模工作流程,並使用 編輯在 Studio 選項卡以參考設計。
創建和屬性
使用者在您的體驗創建並儲存資產後,可以在以下位置查找:
- 牠們的 我的道具欄 頁面。
- 他們的 個人檔案 頁面的 創作 標籤。
- 發展項目標籖 在 創作者面板 下的 開發項目 頁面。
- Studio 中的 工具箱 標籤的 道具欄 。
當用戶在其朋友的個人資料或道具欄中看到體驗內容時,他們會看到原創體驗的屬性,並且可以點擊屬性鏈接,重新導向體驗頁面,以便他們可以加入體驗並創建自擁有的體驗。