أصول الألعاب على 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.

يستطيع تطبيق الذكاء الاصطناعي لديك رفع الصور والفيديو والصوت وأوراق الرسوم المتحركة والنماذج ثلاثية الأبعاد المحوّلة مسبقًا إلى صيغة ثابتة، بما فيها الصور وأوراق الرسوم المتحركة الإجرائية بعد تحويلها. تعمل النماذج ثلاثية الأبعاد القابلة للتنفيذ (MODEL_3D ذات الفئة الفرعية procedural أو الصيغة CUSTOM) في أدوات PlayDrop الخاصة، لكن الموصّل يرفضها، لأن الواجهة البرمجية لا تشغّل كود المبدعين للتحقق منها. حوّلها مسبقًا إلى صيغة قياسية مثل GLB، أو أشر إلى إصدار منشور بالفعل على PlayDrop.

اصنع رسومًا وأصواتًا جديدة باستخدام إنشاء الأصول بالذكاء الاصطناعي. وللصيغ التي لا يعرفها PlayDrop، راجع صيغ الأصول المخصصة.