ابدأ من هنا

ما يضيفه PlayDrop إلى لعبتك

ما يمكن للعبة PlayDrop فعله باستخدام SDK وcatalogue.json والاستضافة، وأين تعمل كل ميزة، ودليلها: الحفظ ولوحات المتصدرين والمجموعات والخوادم والمزيد.

لعبة PlayDrop هي لعبة ويب يستضيفها PlayDrop ويدرجها ويشغّلها على موقعه وفي تطبيقات PlayDrop لـ iOS وAndroid وWindows وmacOS. في التطبيقات تُلعب اللعبة بملء الشاشة، دون شريط متصفح حولها؛ وهي لعبة الويب نفسها تعمل في عرض الألعاب داخل التطبيق، وليست نسخة أصلية منفصلة. تسرد هذه الصفحة ما يمكن أن يضيفه PlayDrop وأين يوجد توثيق كل جزء.

طريقتان للبدء

	HTML بسيط	حزمة
ما ترسله	ملف HTML واحد مكتفٍ بذاته، حتى 10 MiB	مجلد مبني أو ملف ZIP أو .play مع catalogue.json
PlayDrop SDK	لا	نعم، كل الميزات أدناه
صور صفحة اللعبة والفيديو	لا	نعم
خادم لعبة مستضاف	لا	نعم
الدليل	ألعاب HTML البسيطة	التحزيم

يمكن لأي لعبة أن تبدأ بسيطة ثم تصبح حزمة لاحقًا بالاسم والرابط نفسيهما.

ما يحصل عليه اللاعبون

القدرة	ما تقدمه للاعبين	الدليل
دورة حياة المضيف	إيقاف مؤقت واستئناف بسلاسة، وصوت يتبع كتم اللاعب، وإطار أول سريع	التحميل والإيقاف المؤقت والصوت
التخطيط بملء الشاشة	لعب من حافة إلى حافة مع واجهة لعب بعيدة عن نتوءات الشاشة وأدوات التحكم في PlayDrop	ملء الشاشة والمناطق الآمنة
الحفظ السحابي	تقدم يرافق اللاعب بين الأجهزة	الحفظ السحابي
لوحات المتصدرين	أعلى النتائج ومرتبة اللاعب	لوحات المتصدرين
الإنجازات	أهداف بأيقونات وتقدم	الإنجازات
المشاركة والدعوات	نوافذ مشاركة مع صورة أو مقطع، ودعوات للأصدقاء، وبطاقات ألعاب في الدردشة	المشاركة والأصدقاء والدعوات
المجموعات والصوت عبر الإنترنت	ينضم الأصدقاء معًا إلى الغرفة نفسها، مع صوت اختياري في الغرفة	المجموعات والصوت عبر الإنترنت
المجموعات المحلية ووحدات التحكم	وحدات تحكم فعلية وهواتف تعمل كوحدات تحكم على شاشة واحدة	المجموعات المحلية ووحدات التحكم
الخوادم الفورية	غرف Colyseus مع قاعدة بيانات MongoDB لكل لعبة	خوادم الألعاب الفورية
التقييمات والإكراميات والمشتريات والإعلانات	طرق يدعم بها اللاعبون اللعبة؛ ورصيد للمبدع	تحقيق الدخل
الأصول والإنشاء بالذكاء الاصطناعي	أصول مشتركة ووسائط مُنشأة وإبداعات اللاعبين	أصول اللعبة، أصول الذكاء الاصطناعي، الصيغ المخصصة

ما تحصل عليه صفحة اللعبة

يمنح catalogue.json اللعبة صفحتها: العنوان والوصف والنوع والوسوم، والأيقونة والصور الرئيسية ولقطات الشاشة والفيديو، والترجمات، وأهلية Instant. ويقرر الظهور من يمكنه فتحها: خاصة للاختبار، أو غير مدرجة لكل من لديه الرابط، أو عامة لتُكتشف على PlayDrop ومتاحة لمحركات البحث. يتيح الإدراج العام فرصًا للاكتشاف؛ لكنه لا يضمن اللاعبين.

أين تعمل كل ميزة

يشغّل الموقع والتطبيقات اللعبة نفسها مع SDK نفسه، لكن بعض ميزات المضيف تعتمد على الجهاز:

لا يعمل الاهتزاز إلا في التطبيقات الأصلية؛ وتخبرك sdk.haptics.supported بذلك.
مشاركة مقطع فيديو تعتمد على المضيف؛ والبيئات المضيفة التي لا تدعمها ترفض الطلب بدل مشاركة رابط عادي.
يتم اللعب دون اتصال وتحميل الملفات مسبقًا في التطبيقات الأصلية للألعاب التي تصرّح بهما؛ أما الموقع فيحمّل الألعاب عبر الإنترنت.
يعتمد صوت الغرفة والمجموعات على نسخة المضيف وتسجيل الدخول وطرح الميزة على المنصة.
تعتمد الإعلانات على المضيف وعلى المخزون المتاح؛ وتبلّغ load() عندما لا يكون أي إعلان جاهزًا.

صمّم اللعبة بحيث تبقى قابلة للعب عندما تغيب خدمة اختيارية.

ابدأ مع SDK

حمّل SDK، واقرأ حالة المضيف، ثم أعلن الجاهزية عندما يظهر الإطار الأول كما صممته على الشاشة:

html

<script src="https://assets.playdrop.ai/sdk/playdrop.js"></script>
<script type="module">
  const sdk = await playdrop.init();
  // Set up pause, audio and HUD from sdk.host, then render the first frame.
  sdk.host.ready();
</script>

تابع مع التحميل والإيقاف المؤقت والصوت. ويسرد مرجع SDK للعميل كل مساحات الأسماء.

ما لا يستطيع الموصّل فعله

ينشر تطبيق الذكاء الاصطناعي لديك الألعاب المبنية ويقرأ حسابك. لكنه لا يستطيع فتح الألعاب المصنوعة في PlayDrop Studio أو تغييرها، ولا إعادة الكود المصدري، ولا رفع كود نماذج ثلاثية الأبعاد قابلة للتنفيذ. هذه حدود الموصّل، لا المنصة: ما زال Studio وأدوات PlayDrop الخاصة قادرين على ذلك.