แอสเซ็ตเกมบน PlayDrop: ไฟล์ในแพ็กเกจ แอสเซ็ตของเกม และแพ็กที่ใช้ร่วมกัน

วางไฟล์ไว้ข้างเกมและโหลดด้วยพาธแบบสัมพัทธ์ เช่น assets/music.mp3 ไฟล์เหล่านี้อัปโหลดไปพร้อมแพ็กเกจ และถูกแคชโดยเบราว์เซอร์และแอป ระบุไฟล์ที่จำเป็นต่อการเริ่มเกมใน prefetch.required เพื่อให้แอปดาวน์โหลดได้ล่วงหน้า (วงจรชีวิต) เกม HTML แบบง่ายต้องฝังแอสเซ็ตไว้ในไฟล์แทน

ประกาศแอสเซ็ตที่เกมเป็นเจ้าของไว้ในรายการแคตตาล็อกของเกม แต่ละรายการจะกลายเป็นแอสเซ็ต PlayDrop ที่มีหน้าของตัวเอง และผูกกับเกมนี้:

{
  "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 เป็น IMAGE, VIDEO, AUDIO, SPRITESHEET, MODEL_3D หรือ CUSTOM โดย subcategory และ format ใช้ระบุให้ละเอียดขึ้น
• files จับคู่บทบาทกับพาธ เสียงต้องมี primary ส่วนสไปรต์ชีตต้องมี atlas และ manifest
• runtimeKey คือชื่อที่เกมใช้หาแอสเซ็ตขณะรัน
• ไม่บังคับ: visibility, license, tags และ shopListed พร้อม shopPriceCredits เพื่อขายแอสเซ็ต

อ้างอิงแอสเซ็ตที่เผยแพร่แล้วตามรีวิชันที่แน่ชัด และอ้างอิงแพ็กตามเวอร์ชัน:

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

เรียกดูได้ที่แอสเซ็ต PlayDrop หรือด้วย sdk.assets.catalog.listPublic(), sdk.assets.packs.listPublic() และ sdk.search.query() เกมสาธารณะใช้ได้เฉพาะแอสเซ็ตและแพ็กสาธารณะ และต้องเคารพสัญญาอนุญาตของแต่ละแอสเซ็ต

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

แต่ละผลลัพธ์มี assetRef, runtimeKey, sourceType (OWNED, DIRECT หรือ PACK) และ files ที่มี role, url, contentType และ sizeBytes

แอป AI ของคุณอัปโหลดภาพ วิดีโอ เสียง สไปรต์ชีต และโมเดล 3D สำเร็จรูปได้ รวมถึงภาพและสไปรต์ชีตแบบโพรซีเจอรัลที่แปลงเป็นไฟล์สำเร็จรูปแล้ว โมเดล 3D ที่รันโค้ดได้ (MODEL_3D ที่มีหมวดย่อย procedural หรือรูปแบบ CUSTOM) ทำงานในเครื่องมือของ PlayDrop เอง แต่คอนเนกเตอร์จะปฏิเสธ เพราะ API ไม่รันโค้ดของครีเอเตอร์เพื่อตรวจสอบ ให้แปลงเป็นรูปแบบมาตรฐาน เช่น GLB หรืออ้างอิงเวอร์ชันที่เผยแพร่บน PlayDrop แล้ว

สร้างภาพและเสียงใหม่ได้ด้วยการสร้างแอสเซ็ตด้วย AI สำหรับรูปแบบที่ PlayDrop ไม่รู้จัก ดูรูปแบบแอสเซ็ตที่กำหนดเอง