בדף הזה מפורטת היסטוריית הגרסאות של המסמכים הבאים:
- דרישות בנושא נגישות
- הנחיות לגבי עיצוב משחקים במשחקייה
- Playables SDK
- דרישות טכניות
- דרישות בנושא אמון ובטיחות
25 באוגוסט 2026
- עדכנו את דרישות האמינות והבטיחות כדי להוסיף את המדיניות בנושא תוכן כפול (סעיף 2.2). המדיניות הזו מחייבת תוכן מקורי, מורשה או בעל רישיון, ואוסרת על יצירת גרסאות כפולות של משחקים.
24 באוגוסט 2026
- הוספנו תגים של נגישות למשחקים (קטעים 2 ו-2.1) שמתייחסים לגילוי שחקנים במסגרת Accessible Gaming Initiative (AGI) ולדיוק המטא-נתונים של המפתחים.
11 ביולי 2024
- הדרישות הטכניות פוצלו לכמה דפים.
- דרישות לניקוי ולביטול כפילויות.
24 ביוני 2024
הגדלנו את מגבלת הגודל הכוללת של חבילות מ-100MB ל-250MB והוספנו הנחיות לגבי טעינה עצלה.
17 ביוני 2024
עדכונים בכלי לבדיקת ההגדרה של תהליך בחירת הרשת (Mediation):
- אין יותר צורך להציג משחקים באמצעות HTTPS, ואפשר להציג אותם מ-localhost לצורך בדיקה.
- נוסף כפתור רענון לצד שדה כתובת ה-URL כדי לרענן את התוכן של iframe בלי לטעון מחדש את כל כלי הבדיקה.
16 במאי 2024
להעביר את השיטות המומלצות לעיצוב למסמך נפרד כדי להבחין טוב יותר בין דרישות העיצוב לבין השיטות המומלצות.
8 במאי 2024
שיפרנו את האתר למפתחים של מודעות אינטראקטיביות כדי להרחיב את הגישה ולשפר את הניווט.
7 במאי 2024
הדרישות הטכניות של ההתראה על מוכנות המשחק עודכנו עם פרטים נוספים לגבי הקריאה firstFrameReady.
3 במאי 2024
- יצרנו ארכיון של גרסאות קודמות של הדרישות.
5 במרץ 2024
הגדלנו את מגבלת הגודל של כל קובץ מ-10MiB ל-30MiB.
23 בפברואר 2024
הוספנו IN_PLAYABLES_ENV boolean למרחב השמות ברמה העליונה כדי להודיע למפתחים מתי המשחק שלהם פועל בסביבת המשחקייה.
4 בדצמבר 2023
עדכונים בחבילת הבדיקות
- הוספנו בדיקה של תווים לא נתמכים בשמות קבצים.
- מידע על התווים הנתמכים מופיע במאמר דרישות טכניות – 1.9 שמות קבצים.
- מגבלה ידועה: יכול להיות שהבדיקה הזו לא תאמת את כל המשאבים שנטענו.
- נוספה תכונה לסימול מסך הטעינה, כולל הגדרת הגובה הראשוני של ה-iframe ל-0.
- עדכנו את כפתור ההשהיה וההפעלה מחדש כך שיתאים יותר להפקה, על ידי הפעלה או השבתה של האודיו כשמשהים וממשיכים את ההפעלה.
- הוסרו הודעות שלא דורשות פעולה מרישום האירועים.
10 בנובמבר 2023
חבילת הבדיקה (Test Suite) שניתן להוריד הוחלפה בחבילת הבדיקה שמתארחת ב-AdMob.
קובץ הגדרות הטיפוס של TypeScript, שהיה זמין בעבר בחבילה של Test Suite, הועבר למאמר הראשי בנושא Playables SDK.
7 בספטמבר 2023
הקטע תחילת העבודה עודכן כדי לשנות את כתובת ה-URL של Playables
SDK מ-v0 ל-v1.
30 באוגוסט 2023
הקטעים שמות קבצים ותמונות ממוזערות עודכנו, והוסרו מהם ההפניות לרשימה מפורשת של התווים המיוחדים המותרים (_, -, .).
בנוסף, עדכנו את הסעיף שמירת נתונים בענן כך שנדרשת שמירת נתונים בענן כדי להפעיל גרסאות חדשות של משחקים.
25 באוגוסט 2023
עדכנו את הסעיף saveData כדי להבהיר שנתוני השמירה צריכים להיות מחרוזת UTF-16 תקינה ומעוצבת היטב.
18 באוגוסט 2023
עדכנו את הקטע השהיה והמשך כדי להבהיר שהמשחק צריך להשהות את כל ההרצות אחרי הקריאה ל-onPause ולהמשיך רק אחרי הקריאה ל-onResume.
11 באוגוסט 2023
הוספנו את הקטע שמות קבצים כדי לכלול מגבלות על מספר התווים שמשמשים למתן שמות לקבצים בחבילת המשחק.
10 באוגוסט 2023
הקטע שיטות אינטראקציה עודכן כך שכל רכיבי ממשק המשתמש של המשחק צריכים לפעול כמצופה וללא שגיאות או התנהגויות לא צפויות.
9 באוגוסט 2023
הוספנו את הקטע תמונות ממוזערות כדי לפרט את הדרישות לתמונות הממוזערות של המשחק, וכך לאפשר למשתמשים לגלות ולזהות בקלות משחקים שאפשר לשחק ב-YouTube.
8 באוגוסט 2023
עדכנו את הקטע מחוות וקלט כדי לאסור על המשחק להפעיל את preventDefault() באירועי Esc.
בנוסף, נוסף קטע חדש File references (הפניות לקבצים) כדי לחייב שימוש בנתיבים יחסיים בלבד במשחקים כשמתייחסים לקבצים אחרים בחבילה, כי שימוש בנתיבים מוחלטים עלול לגרום לשגיאה.
2 באוגוסט 2023
הקטע בנושא השתקה במסמכים דרישות טכניות והנחיות לעיצוב משחקים שניתן לשחק בהם עודכן. מעכשיו, התכונות להשתקה ולביטול ההשתקה נקראות אמצעי בקרה של האודיו, ומצוין שאמצעי הבקרה המפורטים של האודיו עשויים לכלול סרגלי עוצמת קול, מתג השתקה או את שניהם.
28 ביולי 2023
עדכנו את המסמכים של הנחיות העיצוב של משחקים שאפשר לשחק בהם כדי ליצור אחידות בטרמינולוגיה ולעדכן את השיטות המומלצות וצילומי המסך.
20 ביולי 2023
הוספנו את הקטע השהיה והמשך כדי לספק יכולות השהיה והמשך בפלטפורמות שונות.
19 ביולי 2023
באתר של המשחקייה של YouTube יש עכשיו מסמכי הנחיות לעיצוב משחקים במשחקייה, כדי לעזור לכם לספק חוויית משחק אופטימלית למשתמשים שמשחקים במשחקי YouTube במכשירים ובפלטפורמות שונים.
ההנחיות לעיצוב המשחק מתמקדות בתחומים הבאים:
- תמונות ממוזערות
- התאמה למכשיר
- ממשק משתמש (UI)
- תנועות וקלט
- השהיה
- השתקה
- משוב פיזי
- הדרכה למשתמשים חדשים
- סיום המשחק (מסך הניצחון)
- נגישות
בנוסף, עדכנו את הקטע onAudioEnabledChange כדי לתקן שגיאת הקלדה קטנה בקוד שגרמה לשגיאה בשכבת ה-JavaScript interoperability (JS-Interop) המוצעת של Flutter.
14 ביולי 2023
הקטע גודל עודכן באופן הבא:
- הסרנו את הדרישה שהמשחק יהיה ניתן להפעלה במסך מלא במחשב, ובפריסה לרוחב או לאורך בנייד.
- הוספנו שהמשחק צריך להיות ניתן להפעלה בפריסה לאורך.
- הוספנו שהמשחק צריך להיות ניתן להפעלה במצב לרוחב. אחרת, המשחק צריך להיות ממוקם במרכז או לכלול תיבת עמודות.
- הוספנו שהמשחק לא יכול לנעול את כיוון המכשיר.
11 ביולי 2023
נוסף הקטע Flutter web (ניסוי) כדי לאפשר שילוב עם משחקים שנכתבו באמצעות Flutter Web.
1 ביולי 2023
בקטע החלפת מצב השתקה נדרש שהמשחק יכבד את הגדרת האודיו של YouTube ושל המערכת, ושהצליל של המשחק לא יופעל באופן לא צפוי.
בנוסף, בסעיף השלמת הטיפול בתוכן מובהר שהמשחק צריך להודיע למשתמש שאין יותר תוכן שאפשר ליצור איתו אינטראקציה, כמו בשלב האחרון או בסיום המשחק.
30 ביוני 2023
בקטע תחילת העבודה נוספה הערה שלפיה ה-SDK לא יבצע פעולה כשהמשחק מוגש באופן מקומי. כדי לוודא שהשילוב של ה-SDK בוצע כראוי, אפשר לעיין במאמר בנושא SDK Test Suite.
2 ביוני 2023
באתר של 'המשחקייה' ב-YouTube יש עכשיו תיעוד של Playables SDK, שכולל קבוצה חזקה של ממשקי API לתמיכה במשחקים ב-YouTube.
26 במאי 2023
אלה העדכונים במסמכי הדרישות הטכניות:
| קטע | השינויים |
|---|---|
| זמן טעינה | הוספנו את מהירות האינטרנט הממוצעת בעולם, שהיא 6.8Mbps, ואת מהירות האינטרנט הממוצעת בארה"ב, שהיא 20Mbps. |
| שיטות אינטראקציה | הוספנו שאם משתמש מקיים אינטראקציה עם המשחק, המשחק לא יכול לעכב או להתעלם מהקלט שלא במכוון. |
| תמונות ממוזערות | עדכנו את הרזולוציות הנדרשות של תמונות ביחסים 1:1, 5:7 ו-16:9. |
| פרטים של בעל האפליקציה או המפתח | הוספנו את הקטע החדש הזה שבו נדרש לכלול במשחק את השם של המפיץ או המפתח, ויכול להיות שבעתיד יהיה צורך גם לספק סיווג תוכן. |
| טעינת Playables SDK | הוספנו קטע חדש שבו נדרש שהמשחק יטען את Playables SDK לפני כל קוד אחר של המשחק. |
| התראה על מוכנות המשחק | העדכון מאפשר לשלוח קריאה ל-firstFrameReady API רק כשהפריים הראשון של המשחק מוכן לרינדור במסך, ורק כשהמשחק מוכן לאינטראקציית משתמש.gameReady |
| השתקה וביטול ההשתקה | הוספנו שאם ההשתקה ב-YouTube מוגדרת, האודיו לא צריך להיות מופק, ושפקדי ההשתקה או ביטול ההשתקה של המשחק לא צריכים להשפיע על פלט האודיו. |
24 במרץ 2023
באתר של המשחקייה של YouTube יש עכשיו מסמכי דרישות טכניות שמטרתם לספק חוויית משחק חלקה למשתמשים שמשחקים משחקים ב-YouTube.
החלק של הדרישות הטכניות מתמקד בתחומים הבאים:
- יציבות המשחק
- החוויה ב-YouTube
- שילוב עם YouTube
- Localization
- מונטיזציה