בקטע הזה מוסבר על השילוב בין המשחקייה לבין YouTube Playables SDK.
1 טוענים את Playables SDK
- המשחק חייב לטעון את SDK המשחקייה של YouTube לפני כל קוד המשחק.
2 התראה על כך שהמשחק מוכן
- המשחק חייב להפעיל את
firstFrameReadyכשהוא מבצע רינדור של מסך טעינה או מסך פתיחה שמודיע למשתמש באופן מפורש שתהליך הטעינה מתבצע. - המשחק חייב להתקשר אל
gameReadyוחייב להתקשר אלgameReadyרק כשהמשחק מוכן לאינטראקציה עם המשתמש (לדוגמה: התפריט הראשי או שהמשחק מוכן להפעלה). - אסור למשחק להפעיל את הפונקציה
gameReadyבזמן שעדיין מוצגים למשתמש רכיבים שלא ניתן ליצור איתם אינטראקציה (לדוגמה: מסכי פתיחה או מסכי טעינה).
מערכת YouTube לא מסירה את סמל הטעינה עד שמתבצעת קריאה ל-API הזה.
3 ציוני משתמשים
- יכול להיות שהמשחק ישתמש ב-
sendScoreכדי לשלוח את הציון של המשתמש. - אם המשחק משתמש ב-
sendScoreכדי לשלוח תוצאות, המשחק חייב לפעול בהתאם למפרט שלsendScoreוחייב לוודא שהתוצאה הכי טובה שנשלחת זהה לתוצאה הכי טובה ששמורה במשחק.
4 שמירות בענן
- המשחק חייב לקרוא ל-
saveDataכדי לשמור את ההתקדמות כשהמשתמשים מתקדמים במשחק (לדוגמה, שינוי רמה) באופן שגורם להם להאמין שההתקדמות שלהם נשמרת. - אסור למשחק להשתמש במנגנון אחר כדי לשמור את ההתקדמות של המשתמש. התכונה הזו מאפשרת לשחקנים להמשיך את המשחק במועד מאוחר יותר.
- המשחק חייב להמתין
loadDataלפני שהוא קורא ל-saveData. אם מתבצעת קריאה ל-saveDataלפני ש-loadDataמסתיים בהצלחה, הבקשה תידחה. כך המשחק לא ידרוס נתונים שנשמרו בעבר. - המשחק חייב להיות מסוגל להשתמש בנתוני שמירה בענן מגרסאות קודמות של המשחק ללא שגיאות או קריסות.
- המשחק צריך להשתמש בנתוני השמירה בענן כדי לשמור על התקדמות המשתמש בכל גרסאות המשחק שבהן המשתמש מצפה שהנתונים שלו ישמשו.
- משחקים צריכים לשמור באופן אוטומטי את ההתקדמות של המשתמשים באבני דרך חשובות במשחק כדי למנוע אובדן נתונים. שמירה סופית מתבצעת כשמשתמש יוצא מהמשחק, אבל היא מתבצעת כמיטב היכולת ויכולה לשמור רק עד 64KiB באורך התוכן.
5 השתקה וביטול ההשתקה
- המשחק חייב להתחשב בהגדרת האודיו של המערכת ובלחצן ההשתקה.
- המשחק חייב להתחשב בהגדרת האודיו של YouTube ובלחצן ההשתקה באמצעות
isAudioEnabledו-onAudioEnabledChange. - המשחק חייב להתחשב בשליטה בעוצמת הקול במכשיר.
- צלילי המשחק לא יכולים להיות מושמעים באופן לא צפוי.
- כשההשתקה ב-YouTube מוגדרת, אסור להוציא אודיו, והפקדים של האודיו במשחק לא יכולים להשפיע על פלט האודיו.
- אם ההשתקה ב-YouTube לא מוגדרת, יכול להיות שפקדי האודיו של המשחק ישפיעו על פלט האודיו.
- אסור להציג במשחק לחצן להשתקה כללית בתוך המשחק עצמו. צריך לאפשר למשתמשים להסתמך על התכונות ברמת YouTube לצורך זה.
- יכול להיות שבמשחק יש אמצעי בקרה נפרדים ומפורטים על האודיו, למשל על המוזיקה והאפקטים הקוליים, אבל חובה שהם יעמדו בכל הדרישות האחרות בנוגע לאמצעי בקרה על האודיו.
6 השהיה והמשך
Playables SDK מספק קריאות חוזרות (callback) להשהיה ולחידוש של יכולות בפלטפורמות שונות.
- המשחק חייב להשהות את כל ההרצה אחרי שמפעילים את
onPause, וחייב להמשיך את ההרצה רק אחרי שמפעילים אתonResume. הביצוע כולל את כל היכולות של מודעות אינטראקטיביות, כמו לולאת משחק, מוזיקה, אינטראקציות, קריאות לרשת ועיבוד. - אסור למשחק להשתמש ב-Page Visibility API לאינטרנט או בממשקי API דומים לאינטרנט, וחובה להשתמש רק ב-Playables SDK
onPauseוב-onResume. - המשחק צריך לשמור את התקדמות המשתמש כשמתרחש
onPause.