Game-assets: meegeleverde bestanden, eigen assets en assetpakketten

Zet bestanden naast de game en laad ze met relatieve paden, zoals assets/music.mp3. Ze worden geüpload met het pakket en gecachet door de browser en de apps. Zet de bestanden die nodig zijn om te starten in prefetch.required, zodat de apps ze vroeg kunnen downloaden (levenscyclus). Een eenvoudige HTML-game moet zijn assets in plaats daarvan inline opnemen.

Declareer de assets die de game bezit in zijn catalogusitem. Elk ervan wordt een PlayDrop-asset met een eigen pagina, gekoppeld aan deze game:

{
  "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 is IMAGE, VIDEO, AUDIO, SPRITESHEET, MODEL_3D of CUSTOM; subcategory en format verfijnen dit.
• files koppelt rollen aan paden. Audio heeft primary nodig; spritesheets hebben atlas en manifest nodig.
• runtimeKey is de naam waarmee de game de asset tijdens het spelen vindt.
• Optioneel: visibility, license, tags, en shopListed met shopPriceCredits om de asset te verkopen.

Verwijs naar gepubliceerde assets op exacte revisie en naar assetpakketten op versie:

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

Blader erdoor op PlayDrop-assets of met sdk.assets.catalog.listPublic(), sdk.assets.packs.listPublic() en sdk.search.query(). Een openbare game kan alleen openbare assets en assetpakketten gebruiken; respecteer de licentie van elke asset.

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

Elk resultaat heeft assetRef, runtimeKey, sourceType (OWNED, DIRECT of PACK) en files met role, url, contentType en sizeBytes.

Je AI-app kan afbeeldingen, video, audio, spritesheets en gebakken 3D-modellen uploaden, inclusief gebakken procedurele afbeeldingen en spritesheets. Uitvoerbare 3D-modellen (MODEL_3D met de subcategorie procedural of het formaat CUSTOM) draaien in de eigen tools van PlayDrop, maar worden door de connector geweigerd, omdat de API geen code van makers uitvoert om ze te valideren. Bak ze naar een standaardformaat zoals GLB, of verwijs naar een versie die al op PlayDrop is gepubliceerd.

Maak nieuwe afbeeldingen en geluiden met AI-assets genereren. Voor formaten die PlayDrop niet kent, zie eigen assetformaten.