SDK של המשחקייה ב-YouTube – איך מתחילים

‫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_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.
  • ‫ytgame.ads.requestInterstitialAd() ו-requestRewardedAd(rewardId: string) – שילוב תכונות של מודעות במשחק.

פרטים על ההטמעה ופונקציות נוספות זמינים במאמר בנושא Playables SDK.

הגדרות סוגים ב-TypeScript

למשחקים שמשתמשים ב-TypeScript, מורידים הגדרות סוג.

משחקים לדוגמה

יש דוגמאות שמדגימות איך לשלב את YouTube Playables SDK, כולל JavaScript רגיל, Flutter web,‏ Godot ו-Unity.

בדיקת המשחק באמצעות חבילת מקרים לבדיקה

כשתהיו מוכנים, תוכלו לאמת את השילוב באמצעות חבילת מקרים לבדיקה. כדי ללמוד איך, אפשר לעיין במדריך לחבילת מקרים לבדיקה.