בדף הזה מופיעה היסטוריית הגרסאות של המסמכים הבאים:
- דרישות נגישות
- דרישות המונטיזציה
- הנחיות לעיצוב משחקים ב"משחקייה"
- Playables SDK
- דרישות טכניות
- דרישות בנושא מהימנות ובטיחות
16 באוקטובר 2026
- עדכנו את הדרישות להפעלת מונטיזציה כדי לציין שאי עמידה בהן עלולה לגרום להשבתת תכונות המונטיזציה, והוספנו דרישות לגבי פרסים כספיים בעולם האמיתי (סעיף 1), מודעות מתגמלות (סעיף 2.1), מודעות מעברון (סעיף 2.2) ותוכן ידידותי למפרסמים (סעיף 4).
25 באוגוסט 2026
- עדכנו את הדרישות בנושא אמינות ובטיחות והוספנו את המדיניות בנושא תוכן כפול (סעיף 2.2), שמחייבת תוכן מקורי, מורשה או בעל רישיון, ואוסרת על גרסאות build כפולות של משחקים.
24 באוגוסט 2026
- הוספנו תגי נגישות למשחקים (סעיפים 2 ו-2.1) שכוללים את גילוי השחקנים של Accessible Gaming Initiative (AGI) ואת דיוק המטא-נתונים של המפתחים.
11 ביולי 2024
- הדרישות הטכניות חולקו לכמה דפים.
- ניקוי דרישות והסרת כפילויות.
24 ביוני 2024
הגדלנו את מגבלת הגודל הכולל של החבילה מ-100MiB ל-250MiB והוספנו הנחיות לטעינה מדורגת.
17 ביוני 2024
עדכונים לגבי חבילת המקרים לבדיקה:
- כבר לא צריך להציג משחקים באמצעות HTTPS, ואפשר להציג אותם מ-localhost לצורך בדיקה.
- כפתור הרענון נוסף ליד שדה כתובת ה-URL כדי לרענן את התוכן של ה-iframe בלי לטעון מחדש את כל חבילת המקרים לבדיקה.
16 במאי 2024
כדי להבחין טוב יותר בין דרישות התכנון לבין השיטות המומלצות, כדאי להעביר את השיטות המומלצות למסמך נפרד.
8 במאי 2024
שינינו את המבנה של אתר המפתחים של Playables כדי להרחיב את הגישה ולשפר את הניווט.
7 במאי 2024
עדכנו את הדרישות הטכניות של ההתראה שהמשחק מוכן והוספנו פרטים על הקריאה ל-firstFrameReady.
3 במאי 2024
- יצרנו ארכיון של גרסאות קודמות של הדרישות.
5 במרץ 2024
הגדלנו את מגבלת הגודל של קובץ בודד מ-10MiB ל-30MiB.
23 בפברואר 2024
הוספנו את המשתנה הבוליאני IN_PLAYABLES_ENV למרחב השמות ברמה העליונה כדי להודיע למפתחים כשהמשחק שלהם פועל בסביבת "המשחקייה".
4 בדצמבר 2023
עדכונים בחבילת המקרים לבדיקה
- הוספנו בדיקה של תווים לא נתמכים בשמות של קבצים.
- מידע על התווים הנתמכים זמין בקטע דרישות טכניות – 1.9 שמות קבצים.
- מגבלה ידועה: יכול להיות שהבדיקה הזו לא תאמת את כל המשאבים שנטענו.
- הוספנו תכונה שמדמה את מסך הטעינה, כולל הגדרת הגובה הראשוני של ה-iframe ל-0.
- עדכנו את כפתור ההשהיה וההמשך כדי להתאים אותו יותר לסביבת הייצור, על ידי החלפת מצב האודיו כשמשהים וממשיכים.
- הסרנו הודעות שלא ניתן לבצע בהן פעולה מרישום האירועים ביומן.
10 בנובמבר 2023
חבילת המקרים לבדיקה שניתנת להורדה הוחלפה בחבילת המקרים לבדיקה שמתארחת ב-Google.
קובץ הגדרות הסוג של TypeScript, שהיה זמין בעבר בחבילת המקרים לבדיקה, הועבר למאמר הראשי בנושא 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.
בנוסף, הוספנו קטע חדש בשם הפניות לקבצים, שבו נדרש להשתמש רק בנתיבים יחסיים כשמפנים לקבצים אחרים בחבילה, כי שימוש בנתיבים מוחלטים עלול לגרום לשגיאה.
2 באוגוסט 2023
הקטע "השתקה" בדרישות הטכניות ובהנחיות לעיצוב משחקים ב-Playables עודכן כך שהתכונות "השתקה" ו"ביטול השתקה" נקראות פקדי אודיו, ונוספה הבהרה שפקדי האודיו המפורטים יכולים לכלול סליידרים של עוצמת הקול או מתג השתקה, או את שניהם.
28 ביולי 2023
המסמכים של ההנחיות לעיצוב משחקים ב-Playables עודכנו כדי ליצור ניסוח אחיד ולעדכן את השיטות המומלצות וצילומי המסך.
20 ביולי 2023
הוספנו את הקטע השהיה והמשך כדי לספק יכולות השהיה והמשך בפלטפורמות שונות.
19 ביולי 2023
באתר של המשחקייה של YouTube יש עכשיו את מסמכי התיעוד של ההנחיות לעיצוב משחקים למשחקייה, שמשמשים כמדריך ליצירת חוויית משחק אופטימלית למשתמשים שמשחקים במשחקים של YouTube במכשירים ובפלטפורמות שונים.
ההנחיות לעיצוב המשחק מתמקדות בתחומים הבאים:
- תמונות ממוזערות
- התאמה למכשיר
- ממשק משתמש (UI)
- תנועות וקלט
- השהיה
- השתקה
- משוב פיזי
- הדרכה למשתמשים חדשים
- סיום המשחק (מסך ניצחון)
- נגישות
בנוסף, עדכנו את הקטע onAudioEnabledChange כדי לתקן שגיאת הקלדה קטנה בקוד שגרמה לשגיאה בשכבת יכולת הפעולה ההדדית של JavaScript (JS-Interop) שמוצעת ב-Flutter.
14 ביולי 2023
הקטע גודל עודכן באופן הבא:
- הסרנו את הדרישה שהמשחק יהיה זמין למשחק במסך מלא במחשב ובפריסה לרוחב או לאורך בנייד.
- הוספנו דרישה שהמשחק יהיה זמין במצב לאורך.
- הוספנו דרישה שהמשחק יהיה זמין בפריסה לרוחב. אחרת, המשחק צריך להיות ממורכז או לכלול פסי שוליים שחורים.
- הוספנו את הדרישה שהמשחק לא ינעל את כיוון המכשיר.
11 ביולי 2023
הוספנו את הקטע Flutter web (ניסיוני) כדי לאפשר שילוב עם משחקים שנכתבו באמצעות Flutter Web.
1 ביולי 2023
בקטע מתג ההשתקה, המשחק צריך לפעול בהתאם להגדרות האודיו של YouTube ושל המערכת, והסאונד של המשחק לא יכול לפעול באופן בלתי צפוי.
בנוסף, בסעיף טיפול בתוכן בסיום המשחק מובהר שהמשחק חייב להודיע למשתמש שאין יותר תוכן שאפשר לקיים איתו אינטראקציה, למשל בשלב האחרון או בסיום המשחק.
30 ביוני 2023
בקטע תחילת העבודה יש עכשיו הערה על כך שערכת ה-SDK לא תפעל כשהמשחק מוצג באופן מקומי. כדי לוודא ששילוב ה-SDK תקין, אפשר לעיין במאמר חבילת מקרים לבדיקת SDK.
2 ביוני 2023
האתר של המשחקייה של YouTube כולל עכשיו את מסמכי התיעוד של Playables SDK, שמכילים קבוצה גדולה של ממשקי API לתמיכה במשחקים ב-YouTube.
26 במאי 2023
העדכונים במסמכי התיעוד של הדרישות הטכניות:
| קטע | השינויים |
|---|---|
| זמן טעינה | כולל מהירות האינטרנט הממוצעת של 6.8Mbps ברחבי העולם ו-20Mbps בארה"ב. |
| שיטות אינטראקציה | הוספנו הנחיה שלפיה כשהמשתמש יוצר אינטראקציה עם המשחק, המשחק לא יכול לעכב או להתעלם מהקלט באופן לא מכוון. |
| תמונות ממוזערות | עדכנו את הרזולוציות הנדרשות לתמונות ביחסים 1:1, 5:7 ו-16:9. |
| מידע על בעל התוכן הדיגיטלי או המפתח | הוספנו את הסעיף החדש הזה, שדורש שהמשחק יכלול את שם המפיץ או המפתח. יכול להיות שבעתיד נדרוש גם לספק סיווג תוכן. |
| טעינת Playables SDK | הוספנו את הקטע החדש הזה, שדורש שהמשחק יטען את ה-SDK של Playables לפני כל קוד אחר של המשחק. |
| התראה שהמשחק מוכן | עדכנו את האפליקציה כך שהיא תשלח קריאה ל-API של firstFrameReady רק כשהפריים הראשון של המשחק מוכן לעיבוד במסך, ותשלח קריאה ל-API של gameReady רק כשהמשחק מוכן לאינטראקציה של המשתמש. |
| השתקה וביטול ההשתקה | הוספנו הנחיה שלפיה כשההשתקה של YouTube מופעלת, אסור להשמיע את האודיו, ואסור שפקדי ההשתקה או ביטול ההשתקה של המשחק ישפיעו על פלט האודיו. |
24 במרץ 2023
האתר של המשחקייה של YouTube כולל עכשיו את מסמכי התיעוד של הדרישות הטכניות, במטרה לספק חוויית משחק חלקה למשתמשים שמשחקים ב-YouTube.
הקטע של הדרישות הטכניות מתמקד בתחומים הבאים:
- יציבות המשחק
- חוויית השימוש ב-YouTube
- שילוב עם YouTube
- Localization
- מונטיזציה