Spillressurser: medfølgende filer, egne ressurser og delte pakker

Legg filene ved siden av spillet og last dem inn med relative stier, som assets/music.mp3. De lastes opp med pakken og bufres av nettleseren og appene. List filene som trengs for å starte, i prefetch.required, slik at appene kan laste dem ned tidlig (livssyklus). Et enkelt HTML-spill må i stedet legge ressursene sine inn i selve filen.

Deklarer ressursene spillet eier, i katalogoppføringen. Hver av dem blir en PlayDrop-ressurs med sin egen side, knyttet til dette spillet:

{
  "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 er IMAGE, VIDEO, AUDIO, SPRITESHEET, MODEL_3D eller CUSTOM; subcategory og format presiserer den.
• files knytter roller til stier. Lyd trenger primary; spriteark trenger atlas og manifest.
• runtimeKey er navnet spillet bruker for å finne ressursen under kjøring.
• Valgfritt: visibility, license, tags, og shopListed med shopPriceCredits for å selge den.

Referer til publiserte ressurser etter eksakt revisjon, og til ressurspakker etter versjon:

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

Bla gjennom dem i PlayDrop-ressurser eller med sdk.assets.catalog.listPublic(), sdk.assets.packs.listPublic() og sdk.search.query(). Et offentlig spill kan bare bruke offentlige ressurser og ressurspakker; respekter lisensen til hver ressurs.

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

Hvert resultat har assetRef, runtimeKey, sourceType (OWNED, DIRECT eller PACK) og files med role, url, contentType og sizeBytes.

KI-appen din kan laste opp bilder, video, lyd, spriteark og ferdigbakte 3D-modeller, inkludert ferdigbakte prosedyriske bilder og spriteark. Kjørbare 3D-modeller (MODEL_3D med underkategorien procedural eller formatet CUSTOM) kjører i PlayDrops egne verktøy, men avvises av connectoren, fordi API-et ikke kjører kode fra skapere for å validere dem. Bak dem ferdig til et standardformat som GLB, eller referer til en versjon som allerede er publisert på PlayDrop.

Lag ny grafikk og lyd med KI-generering av ressurser. For formater PlayDrop ikke kjenner, se egendefinerte ressursformater.