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

يغطّي هذا القسم عملية التكامل بين "الإعلانات التفاعلية" وحزمة تطوير البرامج (SDK) الخاصة بالإعلانات التفاعلية على YouTube.

1 تحميل "حزمة تطوير البرامج" (SDK) الخاصة بالإعلانات التفاعلية

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

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

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

3 نتائج المستخدم

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

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

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

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

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

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

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

توفّر حزمة تطوير البرامج (SDK) الخاصة بـ "هيّا نلعب" عمليات معاودة الاتصال لإمكانات الإيقاف المؤقت والاستئناف من عدّة منصات.

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