YouTube Playables SDK הוא ערכת SDK לאינטרנט שמאפשרת לחבר משחקי אינטרנט לסביבת YouTube. ערכת ה-SDK כוללת ממשק API חזק שתומך במשחקים במגוון דרכים, כדי ליצור חוויית משחק מעולה ב-YouTube.
הוספת Playables SDK למשחק
למשחק צריך להיות קובץ index.html בתיקיית השורש. כדי לייבא את YouTube Playables SDK, מוסיפים את השורה הבאה לפני כל קוד המשחק:
<script src="https://www.youtube.com/game_api/v1"></script>
ערכת ה-SDK פועלת כפעולה ללא תוצאה (no-op) כשהמשחק מוצג באופן מקומי. כדי לוודא שהשילוב של ה-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.
בדיקת המשחק באמצעות חבילת הבדיקות
כשתהיו מוכנים, תוכלו לאמת את השילוב באמצעות חבילת הבדיקה. במדריך הזה מוסבר איך עושים את זה.