PlayDrop のゲームアセット：同梱ファイル、所有アセット、共有パック

ファイルをゲームと同じ場所に置き、assets/music.mp3 のような相対パスで読み込みます。ファイルはパッケージと一緒にアップロードされ、ブラウザとアプリにキャッシュされます。起動に必要なファイルを prefetch.required に記載すると、アプリが早めにダウンロードできます（ライフサイクル）。シンプルな 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、販売する場合は 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 が扱っていない形式については、独自アセット形式をご覧ください。