שאלות נפוצות בנושא אישורים

אם יש לכם שאלה שלא מופיעה בדף הזה, אתם יכולים לפנות אלינו באמצעות הפרטים שמופיעים בדף יצירת הקשר עם התמיכה.

יכול להיות שנוסיף לדף הזה שאלות נפוצות ככל שנקבל אותן.

כללי

הקטע הזה כולל שאלות שלא שייכות לקטגוריה ספציפית.

האם אפשר לבדוק את המשחק בסביבת YouTube?

כן – משתמשים בפורטל למפתחים ופועלים לפי הוראות הבדיקה.

המשחק שלי לא מוצג ב-Android או בחבילת המקרים לבדיקה של ה-SDK, מה עליי לעשות?

אם המשחקים לא מוצגים רק ב-Android או בחבילת המקרים לבדיקה של ה-SDK, בדרך כלל זה קורה בגלל האופן שבו המשחקים נטענים ב-WebView. מטעמי ביצועים, המשחק נטען בהתחלה ב-WebView שלא מוצג למשתמש, ולכן הגודל של אזור התצוגה של WebView הוא אפס. כדי לפתור את הבעיה, מומלץ לבצע את הפעולות הבאות:

‫(1) מוודאים שקוד המשחק פועל בלי קשר לגודל של אזור התצוגה.

‫(2) מוודאים שקוד המשחק מטפל בשינוי הגודל של אזור התצוגה, ושהוא לא ממתין או נכשל כשגודל אזור התצוגה הוא אפס.

מומלץ להאזין לאירוע החלון resize ולהגדיר את גובה המשחק רק כש-window.innerHeight הוא לא אפס.

דרישות טכניות

בקטע הזה יש שאלות שקשורות לדרישות הטכניות של המשחקייה של YouTube.

האם אפשר לקבל פטור מהמגבלה על גודל הקובץ הבודד?

לא. גודל הקובץ הבודד הוא מגבלה קשיחה.

איך נמדד גודל החבילה הראשונית?

גודל החבילה הראשונית נמדד לפי הכמות הכוללת של בייטים שהורדו על ידי המודעה מסוג Playable עד להפעלת האירוע gameReady.

המודעות מסוג Playable משתמשות בדחיסת HTTP כשאפשר, כלומר הגודל הראשוני של החבילה עשוי להיות קטן יותר מהגודל הגולמי הכולל של הנכסים. כשבודקים את גודל החבילה הראשונית בSDK Test Suite, אם המארח המקומי לא דוחס את הנכסים, יכול להיות שהגודל יהיה גדול יותר מהגודל שיהיה אחרי פרסום המודעה הניתנת למשחק. כדי לראות את הגודל בפועל של החבילה הראשונית שמוצגת למשחקייה, משתמשים בחבילת המקרים לבדיקה של ה-SDK שמפנה לקובץ index.html מbuild שהועלה, או משנים את הגדרות השרת המקומי כדי להפעיל דחיסת gzip.

הגעתי למגבלת הגודל של קובץ בודד או של החבילה כולה, או שחרגתי ממנה. מה צריך לעשות?

כדי לבצע אופטימיזציה של המשחק ולשפר את הביצועים, כדאי לעיין במאמרים הבאים:

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

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

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

האם אפשר להחריג את הניתוח הפנימי שלי מדרישות הקריאה החיצונית?

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

המשחק מאחזר נתונים ושלבים ממסד נתונים מרוחק, האם זה מקובל?

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

מופיעה שגיאה לגבי הפרה של Content Security Policy (מדיניות אבטחת תוכן) בגלל הפעלת סקריפטים בתוך שורה (inline)

זה קורה כשמשתמשים ב-JavaScript כדי ליצור ולהוסיף תג <script> לדף. מטעמי אבטחה, ב-YouTube משתמשים במדיניות אבטחת תוכן (CSP) שמחייבת סקריפטים לכלול קוד אבטחה מיוחד שנקרא nonce. המערכת של YouTube מוסיפה את הקוד הזה באופן אוטומטי לסקריפטים בקובץ ה-HTML, אבל אתם צריכים להוסיף אותו באופן ידני לכל סקריפט שאתם יוצרים באמצעות קוד.

כשיוצרים תגי סקריפט באופן פרוגרמטי באמצעות JavaScript, צריך למצוא את ה-nonce מהדף ולהחיל אותו על רכיב הסקריפט החדש.

דוגמה:

const script = document.createElement('script');
script.src = '...';
// Find the nonce from the main page and apply it
script.nonce = document.querySelector('script[nonce]')?.nonce;
document.head.appendChild(script);

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

שילוב SDK

בקטע הזה מופיעות שאלות שקשורות לכל אחד מממשקי ה-API של Playables SDK.

נכשלתי בתהליך האישור בגלל בעיות בשילוב האודיו. מה צריך לתקן?

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

כאן אפשר לראות דוגמאות להגדרת אודיו.

Unity

בקטע הזה מופיעות שאלות לגבי שילוב של משחקי Unity קיימים עם ה-SDK של "המשחקייה של YouTube". דוגמאות לשימוש ב-SDK וב-Unity Wrapper זמינות במסמכי התיעוד של המשחקייה של YouTube Unity Wrapper.

אפשר להשתמש בדחיסה מראש של Unity?

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

בחלק מהמשחקים צריך להשתמש בדחיסה מראש של קובצי .wasm או .data של Unity. כדאי להשתמש בדחיסה מראש רק בתנאים הבאים, כי היא עלולה להאט מאוד את זמני הטעינה:

הדרישות הנוספות האלה נובעות מהמגבלות של ארכיטקטורת ההצגה. בשלב הזה, אין תמיכה בכותרות HTTP נוספות או בדחיסת Brotli.

איך אפשר לנהל את עדכוני הפריימים כשהמשחק פועל ברקע?

אפשר להשתמש ב-setTimeout כדי לנהל את עדכוני הפריימים כשהמשחק פועל ברקע. כך אפשר לשלוט בהתנהגויות כמו השהיית אודיו. כדי לבדוק את ניהול הפריימים ברקע, אפשר להפעיל את האפשרות "הפעלה ברקע" בהגדרות הנגן.

הגבלות זיכרון למשחקי Unity

חלק מהמשחקים ב-Unity משתמשים בכמות גדולה של זיכרון, מה שעלול לגרום לחריגה ממגבלות השימוש בזיכרון של מודעות Playable. מומלץ לפעול לפי מאמרי העזרה למפתחים בנושא זיכרון ב-Unity WebGL.