Spelassets på PlayDrop: medföljande filer, egna assets och assetpaket
Leverera bilder, ljud, video och 3D med ett PlayDrop-spel: medföljande filer, spelets egna assets, offentliga assets och assetpaket, och uppslag med sdk.assets.
Ett spel kan ha med sig sina bilder och ljud på tre sätt. Välj det enklaste som gör det du behöver.
| Sätt | Passar för | Så gör du |
|---|---|---|
| Medföljande filer | Allt som bara spelet använder | Leverera dem i paketet och läs in dem med relativa sökvägar |
| Spelets egna assets | Assets som du vill visa på PlayDrop, återanvända eller sälja | Deklarera dem i ownedAssets |
| Offentliga assets och assetpaket | Återanvända assets som andra skapare har publicerat | Referera till dem i uses |
Medföljande filer
Lägg filerna bredvid spelet och läs in dem med relativa sökvägar, som assets/music.mp3. De laddas upp med paketet och cachelagras av webbläsaren och apparna. Lista de filer som behövs för att starta i prefetch.required, så att apparna kan ladda ner dem tidigt (livscykel). Ett enkelt HTML-spel måste i stället bädda in sina assets direkt i filen.
Spelets egna assets
Deklarera de assets som spelet äger i dess katalogpost. Var och en blir en PlayDrop-asset med en egen sida, kopplad till det här spelet:
{
"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ärIMAGE,VIDEO,AUDIO,SPRITESHEET,MODEL_3DellerCUSTOM;subcategoryochformatpreciserar den.fileskopplar roller till sökvägar. Ljud kräverprimary; spritesheets kräveratlasochmanifest.runtimeKeyär namnet som spelet använder för att hitta den när det körs.- Valfritt:
visibility,license,tags, ochshopListedmedshopPriceCreditsför att sälja den.
Offentliga assets och assetpaket
Referera till publicerade assets med exakt revision och till assetpaket med version:
{
"uses": {
"assets": [{ "ref": "asset:someone/forest-tiles@r3", "runtimeKey": "tiles.forest" }],
"packs": ["pack:someone/ui-kit@1.2.0"]
}
}Bläddra bland dem på PlayDrops assets eller med sdk.assets.catalog.listPublic(), sdk.assets.packs.listPublic() och sdk.search.query(). Ett offentligt spel kan bara använda offentliga assets och assetpaket; respektera licensen för varje asset.
Hitta assets när spelet körs
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);Varje resultat har assetRef, runtimeKey, sourceType (OWNED, DIRECT eller PACK) och files med role, url, contentType och sizeBytes.
Det här accepterar connectorn
Din AI-app kan ladda upp bilder, video, ljud, spritesheets och bakade 3D-modeller, inklusive bakade procedurella bilder och spritesheets. Körbara 3D-modeller (MODEL_3D med underkategorin procedural eller formatet CUSTOM) körs i PlayDrops egna verktyg men avvisas av connectorn, eftersom API:et inte kör skaparens kod för att validera dem. Baka dem till ett standardformat som GLB, eller referera till en version som redan är publicerad på PlayDrop.
Gör nya bilder och ljud med AI-generering av assets. För format som PlayDrop inte känner till, se egna assetformat.