YouTube Playables SDK הוא SDK לאינטרנט שמאפשר לחבר משחקי אינטרנט לסביבת המשחקייה של YouTube. ערכת ה-SDK כוללת API חזק שתומך במשחקים במגוון דרכים, כדי ליצור חוויית משחק מצוינת ב-YouTube.
הוספת Playables SDK למשחק
למשחק צריך להיות קובץ index.html בספריית הבסיס. מייבאים את ה-SDK של המשחקייה של YouTube על ידי הוספת השורה הזו לפני כל קוד המשחק:
<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.
בדיקת המשחק באמצעות חבילת הבדיקה
כשתהיו מוכנים, תוכלו לאמת את השילוב באמצעות חבילת הבדיקה. כאן מוסבר איך עושים את זה.