Pelin resurssit: paketoidut tiedostot, omat resurssit ja jaetut paketit

Laita tiedostot pelin viereen ja lataa ne suhteellisilla poluilla, kuten assets/music.mp3. Ne ladataan palveluun paketin mukana, ja selain ja sovellukset tallentavat ne välimuistiin. Luettele aloitukseen tarvittavat tiedostot kentässä prefetch.required, jotta sovellukset voivat ladata ne etukäteen (elinkaari). Yksinkertaisen HTML-pelin on sen sijaan upotettava resurssinsa.

Ilmoita pelin omistamat resurssit sen katalogimerkinnässä. Jokaisesta tulee PlayDrop-resurssi, jolla on oma sivunsa ja joka on liitetty tähän peliin:

{
  "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 on IMAGE, VIDEO, AUDIO, SPRITESHEET, MODEL_3D tai CUSTOM; subcategory ja format tarkentavat sitä.
• files yhdistää roolit polkuihin. Ääni tarvitsee roolin primary; spritesheetit tarvitsevat roolit atlas ja manifest.
• runtimeKey on nimi, jolla peli löytää resurssin ajon aikana.
• Valinnaiset: visibility, license, tags sekä shopListed ja shopPriceCredits resurssin myymiseen.

Viittaa julkaistuihin resursseihin tarkalla revisiolla ja paketteihin versiolla:

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

Selaa niitä sivulla PlayDropin resurssit tai kutsuilla sdk.assets.catalog.listPublic(), sdk.assets.packs.listPublic() ja sdk.search.query(). Julkinen peli voi käyttää vain julkisia resursseja ja paketteja; noudata kunkin resurssin lisenssiä.

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

Jokaisella tuloksella on assetRef, runtimeKey, sourceType (OWNED, DIRECT tai PACK) ja files, jossa on role, url, contentType ja sizeBytes.

Tekoälysovelluksesi voi ladata kuvia, videota, ääntä, spritesheetejä ja valmiiksi leivottuja 3D-malleja, mukaan lukien leivotut proseduraaliset kuvat ja spritesheetit. Suoritettavat 3D-mallit (MODEL_3D, jonka alaluokka on procedural tai muoto CUSTOM) toimivat PlayDropin omissa työkaluissa, mutta connector hylkää ne, koska rajapinta ei suorita tekijän koodia niiden tarkistamiseksi. Leivo ne vakiomuotoon, kuten GLB, tai viittaa versioon, joka on jo julkaistu PlayDropissa.

Tee uusia kuvia ja ääniä tekoälyresurssien luonnilla. PlayDropille tuntemattomista muodoista katso mukautetut resurssimuodot.