PlayDrop 游戏素材：内置文件、自有素材和共享素材包

把文件放在游戏旁边，并通过相对路径加载，例如 assets/music.mp3。它们会随包一起上传，并由浏览器和应用缓存。把启动所需的文件列在 prefetch.required 中，让应用可以提前下载（生命周期）。简单 HTML 游戏则必须把素材内联到文件中。

在游戏的 catalogue 条目中声明游戏拥有的素材。每个素材都会成为一个 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，以及用于出售素材的 shopListed 和 shopPriceCredits。

按确切修订版本引用已发布的素材，按版本引用素材包：

{
  "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 应用可以上传图片、视频、音频、精灵图和已烘焙的 3D 模型，包括已烘焙的程序化图片和精灵图。可执行的 3D 模型（带有 procedural 子类别或 CUSTOM 格式的 MODEL_3D）可以在 PlayDrop 自己的工具中运行，但会被连接器拒绝，因为 API 不会运行创作者的代码来验证它们。请将它们烘焙为 GLB 等标准格式，或引用 PlayDrop 上已发布的版本。

用 AI 素材生成制作新的图片和声音。对于 PlayDrop 不认识的格式，请参阅自定义素材格式。