דרישות השילוב

בקטע הזה אנחנו מסבירים על השילוב בין 'המשחקייה' לבין YouTube SDK של המשחקייה.

ערכת SDK אחת לטעינה של המשחקייה

המשחק חייב לטעון את ה-SDK של המשחקייה ב-YouTube לפני כל קוד משחק.

התראה על 2 משחקים מוכנים

הקריאה חייבת לקרוא למשחק firstFrameReady גם כשמתבצע רינדור של מסך טעינה או מסך פתיחה שמעביר למשתמש באופן מפורש שתהליך הטעינה מתבצע.
חובה להתקשר למשחק gameReady וחייב להתקשר רק gameReady כאשר המשחק מוכן לאינטראקציה של המשתמש (לדוגמה: התפריט הראשי או המשחק מוכן כדי לשחק).
אסור להפעיל את המשחק gameReady בזמן שהוא עדיין לא פעיל רכיבים שמוצגים למשתמש (לדוגמה: מסכי פתיחה או טעינה במסכים).

המערכת של YouTube לא מסירה את "הסימן הוויזואלי של הטעינה" עד לקריאה ל-API הזה.

3 ציוני משתמשים

המשחק MAY יכול להשתמש בסמל sendScore כדי לשלוח את הניקוד של המשתמש.
אם המשחק משתמש ב-sendScore לשליחת ניקוד, המשחק חייב לפעול בהתאם מפרט sendScore וחייב לוודא שהציון הטוב ביותר שנשלח תואם את התוצאה הטובה ביותר במשחק.

4 תמונות שמורות בענן

הקריאה חייבת לקרוא למשחק saveData כדי לשמור את ההתקדמות שהמשתמשים מבצעים התקדמות מהותית במשחק (לדוגמה, שינוי רמה) שבו המשחק גורמים רבים מניעים את המשתמשים להאמין שההתקדמות שלהם נשמרה.
אסור להשתמש במנגנון אחר כדי לשמור את ההתקדמות של המשתמש. הזה התכונה מאפשרת לשחקנים להמשיך את המשחק בשלב מאוחר יותר.
המשחק חייב להמתין loadData לפני שמתקשרים אל saveData. אם המיקום מתבצעת קריאה אל saveData לפני ש-loadData מסיים בהצלחה, הבקשה תידחה. זה מונע מהמשחק להחליף נתונים שנשמרו בעבר.
המשחק חייב להיות מסוגל להשתמש בנתונים השמורים בענן מגרסאות קודמות של משחק ללא שגיאות או קריסות.
המשחק צריך להשתמש בנתוני השמירה בענן כדי לשמור על ההתקדמות של המשתמשים בכל המכשירים גרסאות של משחקים שבהן המשתמש יצפה שייעשה שימוש בנתונים שלו.
המשחקים צריכים לשמור באופן אוטומטי את ההתקדמות של המשתמש במשחק חשוב כדי למנוע אובדן נתונים. פעולת שמירה אחרונה מתבצעת כשהמשתמשים יוצא מהמשחק, אבל הכי טוב שהוא יכול לחסוך רק עד 64KiB בתוכן length

5 מתג להשתקה

המשחק חייב לפעול בהתאם להגדרות האודיו של המערכת וללחצן ההשתקה.
המשחק חייב לפעול בהתאם להגדרות האודיו של YouTube וללחצן ההשתקה באמצעות isAudioEnabled ו-onAudioEnabledChange.
המשחק חייב לפעול בהתאם להגדרת עוצמת הקול במכשיר.
אסור להשמיע צליל באופן בלתי צפוי.
כאשר מגדירים השתקה של YouTube, אסור להפעיל פלט אודיו ואודיו של המשחק אסור להשפיע על פלט האודיו.
אם לא מגדירים 'השתקה' ב-YouTube, פקדי האודיו של המשחק עשויים להשפיע על האודיו הפלט.
במשחק אסור להציג לחצן השתקה כללי בתוך המשחק עצמו. שמאפשרות למשתמשים להסתמך על תכונות ברמת YouTube לשם כך.
במשחק MAY יש בקרות אודיו מפורטות נפרדות, למשל עבור מוזיקה ואפקטים קוליים, אבל הם חייבים להתאים לכל שאר פקדי האודיו בדרישות שלנו.

הגדרות אודיו שונות עבור רקע, sfx,
תיבות דו-שיח

6 השהה והמשך

ה-SDK של 'המשחקייה' מספק קריאות חוזרות (callback) שמספקות השהיה בפלטפורמות שונות ולחדש יכולות.

חובה להשהות את כל ההפעלות אחרי הקריאה אל onPause וחובה ממשיכים בהרצה רק כשמתבצעת קריאה אל onResume. הביצוע כולל את כל יכולות הפעלת משחק, כמו Game לולאה, מוזיקה, אינטראקציות, רשת ושיחות טלפון.
אסור להשתמש במשחק ב-Page Visibility API (API של חשיפת דף) או בממשקי API דומים לאינטרנט, חובה להשתמש רק ב-SDK של המשחקייה onPause וב-onResume.
המשחק צריך לשמור את ההתקדמות של המשתמש כשהמשחק onPause מתרחש.