Aset game di PlayDrop: berkas bawaan, aset milik game, dan pack bersama

Letakkan berkas di samping game dan muat dengan jalur relatif, seperti assets/music.mp3. Berkas ini diunggah bersama paket dan di-cache oleh browser dan aplikasi. Cantumkan berkas yang dibutuhkan untuk memulai di prefetch.required agar aplikasi bisa mengunduhnya lebih awal (siklus hidup). Game HTML sederhana harus menyematkan asetnya langsung di dalam berkas.

Deklarasikan aset milik game di entri katalognya. Setiap aset menjadi aset PlayDrop dengan halamannya sendiri, yang terhubung ke game ini:

{
  "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 bernilai IMAGE, VIDEO, AUDIO, SPRITESHEET, MODEL_3D, atau CUSTOM; subcategory dan format memperinci kategorinya.
• files memetakan peran ke jalur. Audio memerlukan primary; spritesheet memerlukan atlas dan manifest.
• runtimeKey adalah nama yang dipakai game untuk menemukan aset saat berjalan.
• Opsional: visibility, license, tags, serta shopListed dengan shopPriceCredits untuk menjualnya.

Rujuk aset yang sudah diterbitkan berdasarkan revisi persis, dan pack berdasarkan versi:

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

Jelajahi di aset PlayDrop atau dengan sdk.assets.catalog.listPublic(), sdk.assets.packs.listPublic(), dan sdk.search.query(). Game publik hanya bisa memakai aset dan pack publik; patuhi lisensi setiap aset.

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);

Setiap hasil memiliki assetRef, runtimeKey, sourceType (OWNED, DIRECT, atau PACK), dan files dengan role, url, contentType, serta sizeBytes.

Aplikasi AI Anda bisa mengunggah gambar, video, audio, spritesheet, dan model 3D yang sudah di-bake, termasuk gambar dan spritesheet prosedural yang sudah di-bake. Model 3D yang dapat dieksekusi (MODEL_3D dengan subkategori procedural atau format CUSTOM) berjalan di alat milik PlayDrop sendiri, tetapi ditolak oleh konektor, karena API tidak menjalankan kode kreator untuk memvalidasinya. Bake model tersebut ke format standar seperti GLB, atau rujuk versi yang sudah diterbitkan di PlayDrop.

Buat gambar dan suara baru dengan pembuatan aset AI. Untuk format yang tidak dikenal PlayDrop, lihat format aset kustom.