حزمة تطوير البرامج (SDK) لميزة "هيّا نلعب" في YouTube - البدء

حزمة تطوير البرامج (SDK) لألعاب YouTube Playables هي حزمة تطوير برامج على الويب لربط ألعاب الويب ببيئة YouTube. تتضمّن حزمة SDK واجهة برمجة تطبيقات فعّالة تتيح استخدام الألعاب بطرق متنوعة، وبالتالي توفير تجربة ألعاب ممتازة على YouTube.

إضافة حزمة تطوير البرامج (SDK) لميزة "هيّا نلعب" إلى لعبتك

يجب أن تحتوي اللعبة على ملف index.html في الدليل الجذر. استورِد IDE SDK لألعاب YouTube من خلال إضافة هذا السطر قبل أي رمز من رموز لعبتك:

<script src="https://www.youtube.com/game_api/v1"></script>

ملاحظة مهمة: يجب تحميل حزمة SDK قبل أي رمز من رموز اللعبة. يؤدي ذلك إلى إنشاء بيئة يمكن إعادة إنشائها ووضعها في وضع الحماية، وتوفير وظائف معيّنة ل اللعبة على الفور. ويتم التحقّق من ذلك أثناء النشر، ويمكنك اتّباع دليل مجموعة الاختبارات للتحقّق من ذلك قبل إرسال لعبتك.

يتم تشغيل حزمة تطوير البرامج (SDK) كإجراء لا يؤدي إلى أيّ تأثير عندما يتم عرض لعبتك على الجهاز. للتأكّد من صحة دمج حِزم تطوير البرامج (SDK)، استخدِم دليل مجموعة الاختبار.

الدمج مع حزمة تطوير البرامج (SDK) لميزة "هيّا نلعب"

هناك العديد من عمليات الدمج المطلوبة والاختيارية مع حزمة تطوير البرامج (SDK) لميزة "هيّا نلعب".

عمليات الدمج المطلوبة

راجِع متطلبات النشر بشكل عام، مع التركيز على متطلبات التكامل. راجِع مرجع حزمة تطوير البرامج (SDK) لميزة "الألعاب القابلة للتشغيل" للاطّلاع على تفاصيل التنفيذ.

تشمل الأمثلة ما يلي:

• ytgame.game.firstFrameReady()
• ytgame.game.gameReady()
• ytgame.IN_PLAYABLES_ENV
• ytgame.system.isAudioEnabled()
• ytgame.system.onAudioEnabledChange((isAudioEnabled) => {})
• ytgame.system.onPause(() => {})
• ytgame.system.onResume(() => {})
• ytgame.game.loadData()
• ytgame.game.saveData(data)

عمليات الدمج المقترَحة

بالإضافة إلى عمليات الدمج المطلوبة، تتوفّر عدة وظائف أخرى لإنشاء تجربة تفاعلية للغاية. تشمل الأمثلة ما يلي:

• ‫ytgame.system.getLanguage() - استخدِم هذا الإجراء لاسترداد إعدادات اللغة الحالية للمستخدم. لا تستخدِم دوالّ أخرى أو تخزِّن اللغة في السحابة الإلكترونية حفظ، لأنّ ذلك قد يتغيّر في أي وقت.
• ytgame.engagement.sendScore({ value: newScore }) - يمكنك إرسال أفضل نتيجة إلى YouTube لعرضها.
• ytgame.engagement.openYTContent({ id: videoID }) - افتح فيديو على YouTube.
• ytgame.health.logError() وytgame.health.logWarning(): تسجيل المشاكل في YouTube

راجِع مرجع حزمة تطوير البرامج (SDK) لميزة "الألعاب القابلة للتشغيل" للاطّلاع على تفاصيل التنفيذ ووظائف إضافية.

تعريفات أنواع TypeScript

بالنسبة إلى الألعاب التي تستخدم TypeScript، عليك تنزيل تعريفات الأنواع.

عيّنات الألعاب

تتوفّر نماذج توضّح كيفية الدمج مع حزمة تطوير البرامج (SDK) لميزة "ألعاب قابلة للتشغيل" في YouTube، بما في ذلك JavaScript العادي وFlutter web وGodot وUnity.

اختبار لعبتك باستخدام مجموعة الاختبار

بعد أن تصبح مستعدًا، يمكنك التحقّق من عملية الدمج باستخدام حزمة الاختبار. للتعرّف على كيفية إجراء ذلك، اتّبِع دليل مجموعة الاختبار.