PlayDrop 的遊戲素材：內附檔案、自有素材與共用素材包

將檔案放在遊戲旁邊，並以相對路徑載入，例如 assets/music.mp3。它們會隨套件一起上傳，並由瀏覽器和 App 快取。在 prefetch.required 中列出開始時需要的檔案，讓 App 能提早下載（生命週期）。簡易 HTML 遊戲則必須改為將素材內嵌。

在遊戲的目錄項目中宣告遊戲擁有的素材。每一個都會成為附屬於此遊戲、擁有專屬頁面的 PlayDrop 素材：

{
  "ownedAssets": [
    { "name": "moon-theme", "runtimeKey": "music.main", "displayName": "Moon theme",
      "category": "AUDIO", "files": { "primary": "assets/moon-theme.mp3" } },
    { "name": "astronaut", "runtimeKey": "sprites.player", "displayName": "Astronaut",
      "category": "SPRITESHEET", "files": { "atlas": "assets/astronaut.png", "manifest": "assets/astronaut.json" } }
  ]
}

• category 為 IMAGE、VIDEO、AUDIO、SPRITESHEET、MODEL_3D 或 CUSTOM；subcategory 和 format 可進一步細分。
• files 將檔案角色對應到路徑。音訊需要 primary；精靈圖表需要 atlas 和 manifest。
• runtimeKey 是遊戲在執行時用來找到素材的名稱。
• 選用：visibility、license、tags，以及搭配 shopPriceCredits 的 shopListed，用來販售素材。

依確切修訂版參照已發布的素材，依版本參照素材包：

{
  "uses": {
    "assets": [{ "ref": "asset:someone/forest-tiles@r3", "runtimeKey": "tiles.forest" }],
    "packs": ["pack:someone/ui-kit@1.2.0"]
  }
}

可以在 PlayDrop 素材瀏覽，或使用 sdk.assets.catalog.listPublic()、sdk.assets.packs.listPublic() 和 sdk.search.query()。公開遊戲只能使用公開的素材與素材包；請遵守每個素材的授權。

const music = sdk.assets.resolveAppAsset("music.main");
const file = music.files.find((entry) => entry.role === "primary");
audioElement.src = file.url;

for (const asset of sdk.assets.listAppAssets()) console.log(asset.runtimeKey, asset.sourceType);

每個結果都有 assetRef、runtimeKey、sourceType（OWNED、DIRECT 或 PACK），以及包含 role、url、contentType 和 sizeBytes 的 files。

你的 AI App 可以上傳圖片、影片、音訊、精靈圖表和已烘焙的 3D 模型，包括已烘焙的程序化圖片與精靈圖表。可執行的 3D 模型（procedural 子類別或 CUSTOM 格式的 MODEL_3D）可以在 PlayDrop 自己的工具中執行，但會被連接器拒絕，因為 API 不會執行創作者的程式碼來驗證它們。請將它們烘焙成 GLB 等標準格式，或參照已在 PlayDrop 上發布的版本。

用 AI 素材生成製作新的美術與音效。PlayDrop 無法辨識的格式，請參閱自訂素材格式。