متطلبات الدمج

يغطّي هذا القسم عملية التكامل بين "الإعلانات التفاعلية" وYouTube Playables SDK.

‫1. تحميل Playables SDK

‫2. إشعار "اللعبة جاهزة"

  • يجب أن تستدعي اللعبة firstFrameReady `firstFrameReady` عندما تعرض شاشة تحميل أو شاشة بداية توضّح للمستخدم أنّ عملية التحميل قيد التنفيذ.
  • يجب أن تستدعي اللعبة gameReady ويجب ألا تستدعيها إلا gameReadyعندما تكون جاهزة لتفاعل المستخدم (مثلاً، القائمة الرئيسية أو اللعبة جاهزة للّعب).
  • يجب ألا تستدعي اللعبة gameReady بينما لا تزال عناصر غير تفاعلية معروضة للمستخدم (مثلاً، شاشات البداية أو شاشات التحميل).

لا يزيل YouTube "مؤشر التحميل" إلى أن يتم استدعاء واجهة برمجة التطبيقات هذه.

‫3. نتائج المستخدمين

  • يجوز للعبة استخدام sendScore لإرسال نتيجة المستخدم.
  • إذا كانت اللعبة تستخدم sendScore لإرسال النتائج، يجب أن تلتزم بـ مواصفات sendScore ويجب أن تضمن تطابق أفضل نتيجة يتم إرسالها مع أفضل نتيجة في ملف حفظ اللعبة.

‫4. عمليات الحفظ في السحابة الإلكترونية

  • يجب أن تستدعي اللعبة saveData لحفظ مستوى التقدّم عندما يحرز المستخدمون تقدّمًا ملموسًا في اللعبة (مثلاً، تغيير المستوى) حيث تؤدي آليات اللعبة إلى اعتقاد المستخدم أنّ مستوى تقدّمه قد تم حفظه.
  • يجب ألا تستخدم اللعبة أي آلية أخرى لحفظ مستوى تقدّم المستخدم. تتيح هذه الميزة للاعبين استئناف اللعبة في وقت لاحق.
  • يجبأن تنتظر اللعبة loadData قبل استدعاء saveData. إذا تم استدعاء saveData قبل اكتمال loadData بنجاح، سيتم رفض الطلب. يمنع ذلك اللعبة من الكتابة فوق أي بيانات تم حفظها سابقًا.
  • يجب أن تتمكّن اللعبة من استخدام بيانات الحفظ في السحابة الإلكترونية من الإصدارات السابقة من اللعبة بدون حدوث أخطاء أو أعطال.
  • يُفضّل أن تستخدم اللعبة بيانات الحفظ في السحابة الإلكترونية للحفاظ على مستوى تقدّم المستخدم في جميع إصدارات اللعبة التي يتوقّع المستخدم استخدام بياناته فيها.
  • يُفضّل أن تحفظ الألعاب تلقائيًا مستوى تقدّم المستخدم في مراحل مهمة من اللعبة لمنع فقدان البيانات. يتم إجراء عملية حفظ نهائية عند خروج المستخدم من اللعبة، ولكنها تُبذل فيها أفضل الجهود ولا يمكنها حفظ سوى ما يصل إلى ‎64 KiB من طول المحتوى.

‫5. تفعيل "كتم الصوت" أو إيقافه

  • يجب أن تلتزم اللعبة بإعداد الصوت في النظام وزر كتم الصوت.
  • يجبأن تلتزم اللعبة بإعداد الصوت في YouTube وزر كتم الصوت باستخدام isAudioEnabled و onAudioEnabledChange.
  • يجب أن تلتزم اللعبة بعنصر التحكّم في مستوى الصوت على الجهاز.
  • يجب ألا يتم تشغيل صوت اللعبة بشكل غير متوقَّع.
  • عند ضبط ميزة "كتم الصوت" في YouTube، يجب ألا يتم إخراج الصوت ويجب ألا تؤثر عناصر التحكّم في صوت اللعبة في مصدر إخراج الصوت.
  • عندما لا تكون ميزة "كتم الصوت" في YouTube مفعّلة، يجوز أن تؤثر عناصر التحكّم في صوت اللعبة في إخراج الصوت.
  • يجب ألا تعرض اللعبة زرًا عامًا لكتم الصوت داخل اللعبة نفسها، بل يجب أن تسمح للمستخدمين بالاعتماد على الميزات على مستوى YouTube لهذا الغرض.
  • يجوز أن تتضمّن اللعبة عناصر تحكّم منفصلة ودقيقة في الصوت، مثل الموسيقى والمؤثرات الصوتية، ولكن يجب أن تلتزم بجميع متطلبات التحكّم الأخرى في الصوت.

إعدادات صوت مختلفة للخلفية والمؤثرات الخاصة والحوارات

‫6. الإيقاف المؤقت والاستئناف

يوفّر Playables SDK عمليات معاودة الاتصال لإمكانات الإيقاف المؤقت والاستئناف على جميع المنصات.

  • يجب أن توقف اللعبة جميع عمليات التنفيذ بعد استدعاء onPause ويجب أن تستأنف التنفيذ فقط عند استدعاء onResume. يشمل التنفيذ جميع إمكانات "الإعلانات التفاعلية"، مثل حلقة اللعبة والموسيقى والتفاعلات والطلبات على الشبكة والعرض.
  • **يجب ألا** تستخدم اللعبة واجهة برمجة التطبيقات Page Visibility API على الويب أو واجهات برمجة تطبيقات ويب مشابهة، **ويجب** ألا تستخدم سوى onPause وonResume في Playables SDK.
  • **يُفضّل** أن تحفظ اللعبة مستوى تقدّم المستخدم عند حدوث onPause.