حزمة تطوير البرامج (SDK) "هيّا نلعب على YouTube" هي حزمة تطوير برامج (SDK) على الويب لربط ألعاب الويب ببيئة YouTube. تتضمّن حزمة تطوير البرامج (SDK) واجهة برمجة تطبيقات قوية لدعم الألعاب بطرق متنوّعة من أجل إنشاء تجربة ألعاب ممتازة على YouTube.
إضافة حزمة Playables SDK إلى لعبتك
يجب أن تحتوي اللعبة على ملف index.html في دليلها الجذري. يمكن استيراد حزمة تطوير البرامج (SDK) الخاصة بميزة هيّا نلعب على YouTube من خلال إضافة هذا السطر قبل أي رمز من رموز لعبتك:
<script src="https://www.youtube.com/game_api/v1"></script>
تعمل حزمة تطوير البرامج (SDK) بدون أي إجراء عندما يتم عرض لعبتك محليًا. للتحقّق من صحة عملية دمج حزمة تطوير البرامج (SDK) ، استخدِم دليل مجموعة الاختبارات.
دمج حزمة Playables SDK
هناك عمليات دمج مطلوبة واختيارية مع حزمة Playables SDK.
عمليات التكامل المطلوبة
راجِع متطلبات النشر بشكل عام، مع التركيز على متطلبات التكامل. راجِع مرجع Playables SDK للحصول على تفاصيل التنفيذ.
تشمل الأمثلة ما يلي:
ytgame.game.firstFrameReady()ytgame.game.gameReady()ytgame.IN_PLAYABLES_ENVytgame.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.
راجِع مرجع Playables SDK للحصول على تفاصيل التنفيذ والدوال الإضافية.
تعريفات أنواع TypeScript
بالنسبة إلى الألعاب التي تستخدِم TypeScript، نزِّل تعريفات الأنواع.
ألعاب نموذجية
تتوفّر نماذج توضّح كيفية التكامل مع YouTube Playables SDK، بما في ذلك JavaScript العادي وFlutter web وGodot وUnity.
اختبار لعبتك باستخدام مجموعة الاختبارات
عندما تصبح جاهزًا، يمكنك التحقّق من عملية التكامل باستخدام مجموعة الاختبارات. للتعرّف على كيفية إجراء ذلك، اتّبِع دليل مجموعة الاختبارات.