Recursos de juego: archivos incluidos, propios y paquetes de recursos

Coloca los archivos junto al juego y cárgalos con rutas relativas, como assets/music.mp3. Se suben con el paquete y el navegador y las apps los guardan en caché. Indica en prefetch.required los necesarios para arrancar, para que las apps puedan descargarlos pronto (ciclo de vida). En un juego HTML simple, los recursos deben ir incrustados en el propio archivo.

Declara los recursos propios del juego en su entrada del catálogo. Cada uno se convierte en un recurso de PlayDrop con su propia página, vinculado a este juego:

{
  "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 es IMAGE, VIDEO, AUDIO, SPRITESHEET, MODEL_3D o CUSTOM; subcategory y format la precisan.
• files asocia roles a rutas. El audio necesita primary; las hojas de sprites necesitan atlas y manifest.
• runtimeKey es el nombre que usa el juego para encontrarlo durante la ejecución.
• Opcionales: visibility, license, tags, y shopListed con shopPriceCredits para venderlo.

Haz referencia a los recursos publicados por su revisión exacta, y a los paquetes de recursos por su versión:

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

Explóralos en los recursos de PlayDrop o con sdk.assets.catalog.listPublic(), sdk.assets.packs.listPublic() y sdk.search.query(). Un juego público solo puede usar recursos y paquetes de recursos públicos; respeta la licencia de cada recurso.

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

Cada resultado tiene assetRef, runtimeKey, sourceType (OWNED, DIRECT o PACK) y files con role, url, contentType y sizeBytes.

Tu app de IA puede subir imágenes, vídeo, audio, hojas de sprites y modelos 3D horneados, incluidas imágenes y hojas de sprites procedurales ya horneadas. Los modelos 3D ejecutables (MODEL_3D con la subcategoría procedural o el formato CUSTOM) funcionan en las herramientas propias de PlayDrop, pero el conector los rechaza porque la API no ejecuta código de los creadores para validarlos. Hornéalos en un formato estándar como GLB o haz referencia a una versión ya publicada en PlayDrop.

Crea nuevas imágenes y sonidos con la generación de recursos con IA. Para formatos que PlayDrop no conoce, consulta formatos de recursos personalizados.