בעקבות הוצאה משימוש של Google Sign-In API, אנחנו מסירים את ה-SDK בגרסה Games v1 בשנת 2026. אחרי פברואר 2025, לא תהיה לך אפשרות לפרסם ב-Google Play משחקים ששולבו לאחרונה עם ה-SDK בגרסה Games v1. מומלץ להשתמש ב-SDK בגרסה Games v2.
משחקים קיימים עם שילובים קודמים של Games v1 ימשיכו לפעול למשך כמה שנים, אבל מומלץ לעבור לגרסה 2 החל מיוני 2025.
המדריך הזה מיועד לשימוש ב-Play Games Services SDK בגרסה 1. מידע על גרסת ה-SDK העדכנית זמין במאמרי העזרה בנושא גרסה 2.
איכות המשחק משפיעה על ההצלחה שלו בטווח הארוך – מבחינת התקנות, דירוגים וביקורות של שחקנים, מעורבות ושימור שחקנים. לפני שמפרסמים את המשחק, חשוב לוודא שהוא עומד בציפיות הבסיסיות של הגיימרים באמצעות תכונות מעניינות וממשק משתמש אינטואיטיבי ומעוצב היטב.
המסמך הזה עוזר לכם להתמקד בהיבטים מרכזיים של איכות, מערך תכונות וממשק משתמש שיכולים להשפיע באופן משמעותי על הצלחת המשחק. לכל תחום התמקדות מוצגת רשימת דרישות מינימליות, שיטות מומלצות ושיפורים מומלצים. כדי לספק לשחקנים את המוצר הטוב ביותר שאפשר, מומלץ לפעול לפי ההמלצות שבצ'קליסט ככל האפשר.
1. כניסה
רשימת המשימות הבאה רלוונטית להטמעה של פונקציונליות כניסה של שחקנים במשחק שלכם. במאמר מושגי כניסה מוסבר איך הכניסה פועלת ואיך צריך להטמיע אותה. דוגמאות קוד להטמעת כניסה למשחקים לנייד זמינות במאמר הטמעת כניסה ב-Android.
מזהה | חשיבות | תיאור |
---|---|---|
1.1 | חובה |
כניסה של שחקנים באמצעות שירותי המשחקים של Google Play
|
1.2 | חובה |
אל תבקשו היקפי הרשאה שאינם קשורים ל-Play Games כשאתם יוצרים את לקוח הכניסה. הפעולה הזו תאפשר לשחקנים להיכנס למשחק שלכם באופן אוטומטי, כי בקשה של היקפי הרשאות שאינם של Play Games תגרום למשתמשים להשתמש בכניסה אינטראקטיבית.
אם כבר ביקשתם היקפי הרשאות שאינם קשורים ל-Play Games, צריך להסיר את כל היקפי ההרשאות שלא נחוצים מהקונסטרוקטור
// This is the proper way to do it GoogleSignInOptions signInOption = GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN; |
1.3 | חובה |
מאפשרים לשחקנים להישאר מחוברים.
אחרי שהשחקן נכנס בהצלחה למשחק, מחברים אותו אוטומטית בכל פעם שהמשחק מתחיל, עד שהוא יוצא מהחשבון באופן מפורש. |
1.4 | חובה |
הצגת החלון הקופץ 'מתבצעת התחברות' בצורה מתאימה במהלך הכניסה לחשבון.
במכשירי Android, חלון הקופץ 'מתחבר' של Google Play Games חייב להופיע בכל פעם שמפעילים את תהליך הכניסה. כדי לעשות את זה, צריך להפעיל את ה-method בדוגמה הבאה אפשר לראות איך החלון הקופץ 'מתחבר' עשוי להופיע במשחק ל-Android במהלך הכניסה, ואחריו אנימציה קצרה של הלוגו של Google Play Games Services. ![]() |
1.5 | חובה |
חשוב לספק לשחקנים אפשרות להתנתק.
אחרי הכניסה, תמיד צריכה להיות בנגן אפשרות להתנתק. מומלץ להוסיף לחצן יציאה במסך רלוונטי של המשחק באפליקציה (לדוגמה, במסך ההגדרות של השחקן). |
1.6 | שיטה מומלצת |
חשוב לזכור אם השחקנים סירבו להיכנס לחשבון.
אם השחקן מסרב להיכנס כשהמשחק מתחיל את תהליך הכניסה (לדוגמה, אם הוא לחץ על ביטול בממשק המשתמש של הכניסה), עדיין צריך לאפשר לו להמשיך לשחק. כשנגן המשחקים מפעיל מחדש את המשחק, אל תפעילו אוטומטית את תהליך הכניסה האינטראקטיבי. השחקנים האלה יכולים לבחור להיכנס לחשבון מאוחר יותר באמצעות כפתור הכניסה שמופיע במערכת ההגדרות. כך השחקנים לא צריכים לדחות שוב ושוב את ההצעה להיכנס לחשבון בכל פעם שהם מתחילים לשחק במשחק שלכם. חריג אחד הוא אם השחקנים מנסים לגשת לתכונה במשחק שתלויה בכניסה לחשבון (לדוגמה, שליחת ניקוד לטבלת מובילים). במקרה כזה, צריך לבקש מהם להיכנס לחשבון לפני שממשיכים לשחק. |
1.7 | שיטה מומלצת |
מגדילים את מספר השחקנים שמחוברים.
ככל שיותר שחקנים נכנסים ל-Google Play Games Services, כך השחקנים שלכם נהנים מהזדמנויות רבות יותר למשחק שיתופי ותחרותי. כדי להגדיל את מספר השחקנים שמחוברים ל-Google Play Games Services, מומלץ מאוד להציג לשחקנים באופן אוטומטי בקשה להתחבר, כמו שמתואר למעלה. אחרת, כדאי להפנות את השחקנים לתהליך הכניסה מוקדם ככל האפשר מאחת מהנקודות הבאות (המומלצת ביותר מופיעה ראשונה):
|
1.8 | מומלץ |
הקפדה על הנחיות המיתוג של Google
כדי לספק לשחקנים חוויה מקיפה, מושכת ועקבית, צריך להטמיע את הנחיות המיתוג של Google Play Games Services. |
1.9 | מומלץ |
להזכיר לשחקנים שהם מחוברים.
כשמשחק מבצע פעולה בשם שחקנים שמחוברים לחשבון, צריך להציג להם תזכורת או רמז מתאימים. לדוגמה, כששחקן מחובר מסיים שלב, אפשר להציג לו הודעה כזו כדי לציין שהניקוד וההישגים שלו נטענים אוטומטית: "אתה מחובר לחשבון Google. ההישגים והציונים שלכם יישמרו באופן אוטומטי". |
1.10 | חובה |
גיבוי של התקדמות השחקן באמצעות המזהה של Play Games Services.
כדי לוודא שהשחקנים לא יאבדו את ההתקדמות שלהם כשהם מחליפים מכשירים, מאפסים מכשירים או משחקים בכמה מכשירים, צריך לוודא שההתקדמות שלהם מגובה בפתרון שמירה בענן, ולהשתמש במזהה של Play Games Services כמפתח, באופן מאובטח, אם משתמשים בשרת משחקים משלכם. כששחקנים נכנסים לחשבון באמצעות המזהה שלהם בשירותי המשחקים של Play, צריך לבדוק אם יש התקדמות ששמורה בחשבון הזה. אם כן, צריך לאפשר לשחקן להמשיך מהמקום שבו הוא הפסיק. אפשר להשתמש בפתרון משלכם לשמירה בענן או בתכונה 'משחקים שמורים' בשירותי המשחקים של Play. אם המשתמש לא מחובר, כדאי לנסות לשמור את ההתקדמות של השחקן באופן מקומי, ואז לסנכרן את ההתקדמות הזו כשהשחקן יתחבר בסופו של דבר. כך אפשר למנוע אובדן של התקדמות השחקן אם הוא דוחה את הכניסה למשחק. |
2. הישגים
רשימת המשימות הבאה רלוונטית להטמעה של התכונה הישגים במשחק.
מזהה | חשיבות | תיאור |
---|---|---|
2.1 | חובה | מוודאים שאפשר להשיג את כל ההישגים.
השחקנים צריכים להיות מסוגלים לבטל את הנעילה של כל ההישגים שאתם יוצרים. |
2.2 | שיטה מומלצת | הישגים ייחודיים.
כל התמונות, הטקסט והתיאורים צריכים להיות ייחודיים בכל ההישגים. |
2.3 | שיטה מומלצת | הישגים מקבלים ניקוד באופן יחסי.
נקודות ההישג צריכות להיות פרופורציונליות לכמות הזמן או לרמת המיומנות שנדרשת כדי להשיג את ההישג. |
2.4 | שיטה מומלצת | תכננו הישגים ברמות קושי שונות.
כדאי לכלול כמה הישגים קלים שהשחקן יכול להשיג במהלך משחק רגיל, מספר הישגים ברמת קושי בינונית שדורשים יותר מיומנות או מסירות מהשחקן, והישג או שניים ברמת קושי גבוהה מאוד לשחקנים הכי מסורים. לדוגמה, בצילום המסך הבא מוצג הישג שקשה להשיג, שעוזר לעורר מוטיבציה בקרב מעריצי המשחק ולשמור על נאמנותם. ![]() |
2.5 | מומלץ | אל תציגו את ההישגים בתחילת הסרטון.
כדאי להימנע מהענקת יותר מהישג אחד ב-5 הדקות הראשונות של המשחק, כי שחקנים חדשים במשחק לא יהיו מספיק מעורבים כדי להתעניין בהישגים. אל תגדירו את ההישגים כך שהם יוענקו בטעות מוקדם מדי במהלך המשחק. לדוגמה, כדאי להיזהר מהישגים שסביר להניח שאפשר להשיג בקלות בתחילת המשחק, כמו "השלמת שלב בלי להיפגע". |
2.6 | מומלץ | הגדירו הישגים סביב פעילויות מעניינות במשחק.
בוחרים מדדים ליצירת הישגים שיהפכו את המשחק למעניין יותר ולכזה שכיף לשחק בו שוב (לדוגמה, "מספר הזומבים שהדמות הרגה" הוא מדד מעניין יותר מאשר "מספר הקילומטרים שהדמות הלכה"). |
2.7 | מומלץ | שימוש בסמלי הישגים צבעוניים.
שירותי Google Play Games משתמשים בגרסאות בגווני אפור של סמלי הישגים כדי להראות אם ההישגים הושגו או לא. אם אתם מוגבלים לשימוש בסמלי הישגים שחורים (או לבנים) בלבד, אתם צריכים להציג אותם על רקע צבעוני. |
2.8 | מומלץ | צמצום השימוש בהישגים מוסתרים
השימוש בהישגים מוסתרים צריך להיות מוגבל למקרים שבהם רוצים למנוע ספוילרים במשחק, ולא להיות ברירת המחדל. |
2.9 | מומלץ | כדאי להימנע מהישגים שמסתמכים יותר מדי על מזל.
"Find 100 treasure chests" is a better achievement than "Find an item that has a 1% chance of appearing in a treasure chest." |
2.10 | מומלץ | תחשוב כמו 'צייד הישגים'.
חלק מהשחקנים ינסו להשיג כל הישג שתיצרו. כדאי לנסות לספק הישגים שמתאימים לקטגוריה הזו של שחקנים. אל תיצרו הישגים שמסתמכים יותר מדי על אלמנטים שלא בשליטת השחקן, או שלא ניתן להשיג אותם אחרי שהשחקן קיבל החלטה במשחק. |
2.11 | מומלץ | מוודאים שסמל ההישג מוצג בצורה תקינה.
כשסמל של הישג מוצג בהודעה קופצת ב-Android, הסמל מופיע על רקע של עיגול והפינות החיצוניות שלו מוסתרות. חשוב לוודא שהסמל עדיין נראה טוב בנסיבות האלה. |
3. לוחות לידרבורד
רשימת המשימות הבאה רלוונטית להטמעה של התכונה לוחות לידרבורד במשחק שלכם.
מזהה | חשיבות | תיאור |
---|---|---|
3.1 | שיטה מומלצת | להציג את טבלאות המובילים בתפריט הראשי ואחרי מעברים חשובים. לוחות ה-Leaderboard צריכים להיות נגישים בקלות בזמן טעינת המשחק. אחרי מעברים קריטיים במשחק (לדוגמה, בסוף שלב או כששחקן מת), השחקנים צריכים לראות מיד קישורים לטבלאות הבאז הרלוונטיות. |
3.2 | שיטה מומלצת | הגדרת גבולות עליונים לתוצאות שאפשר לשלוח.
אם אפשר, כדאי להוסיף מגבלות כשמגדירים את טבלאות הניקוד, כדי שמערכת תפסול ציונים מזויפים באופן ברור. |
3.3 | שיטה מומלצת | שימוש בסמלים מותאמים אישית.
צריך ליצור סמל מותאם אישית לכל טבלת הישגים שאתם מגדירים. אל תשתמשו בסמל של המשחק, כי הוא יוצג בצורה לא טובה באפליקציית Google Play Games. |
3.4 | שיטה מומלצת | חשוב לשמור על תדירות מתאימה של שליחת ציונים.
שולחים את הניקוד אחרי מעברים קריטיים במשחק, למשל בסוף שלב או כשהדמות של השחקן מתה במשחק. במשחקים ללא מעברים קריטיים (לדוגמה, משחק מסוג 'ריצה אינסופית'), צריך להפעיל שיקול דעת לגבי התדירות שבה שולחים את הניקוד. אין לשלוח ציונים באופן רציף או כל שנייה. |
3.5 | מומלץ | כדאי להשתמש בתגי ניקוד. תגי ניקוד הם נתונים נוספים שאפשר לשלוח עם הניקוד. לדוגמה, אפשר להטמיע תג ניקוד כדגל כדי לוודא שהניקוד שהשחקן שלח הוא תקף. לוחות תוצאות בהתאמה אישית יכולים גם לקרוא את נתוני התג הזה. לדוגמה, אם תג הניקוד כלל מזהה של סרטון ב-YouTube שבו מוצג מהלך המשחק של השחקן, המשחק יכול ליצור קישור לצפייה בסרטון הזה בתוך הלידרבורד. |
3.6 | מומלץ | עיצוב יצירתי של ממשק משתמש משלכם ללידרבורד
אם יש לכם את המשאבים, תוכלו ליצור תצוגה משלכם של טבלת הישגים בהתאמה אישית על סמך נתוני טבלת ההישגים החברתית. בדרך כלל, טבלאות באז חברתיות יוצרות חוויה מעניינת יותר מטבלאות באז ציבוריות. קודם כל בודקים אם יש רשומות בטבלת הבאז של הקהילה. אם לא, אפשר להשתמש בטבלת המובילים הציבורית. |
3.7 | מומלץ | להראות לשחקנים את הביצועים שלהם בהשוואה למתחרים.
ה-API של טבלאות המובילים תומך בהצגת חלונות של ניקוד (לדוגמה, הדירוג של שחקן מסוים בטווח של 10 מקומות מעל או מתחת למיקום שלו). אם אתם יוצרים תצוגה בהתאמה אישית, זו יכולה להיות דרך יעילה לעודד התעניינות. אפשר להציג את המודעה מיד אחרי מעבר קריטי במשחק (לדוגמה, בסוף רמה או כשדמות במשחק מתה). כדאי להימנע מהוספת קליקים מיותרים בין השחקנים לבין פרטי הדירוג שלהם. |
4. חברים
רשימת המשימות הבאה רלוונטית להטמעה של ממשקי ה-API של Friends במשחק.
מזהה | חשיבות | תיאור |
---|---|---|
4.1 | חובה | כששחקנים מוצגים ברשימה, צריך להציג את הסמל של Play Games
לצד משתמשים שיש להם פרופיל ב-Play Games.
הרשימה יכולה להיות רשימת חברים קיימת, רשימת חברים ששיחקו לאחרונה או רשימת חברים אחרת.
|
4.2 | שיטה מומלצת | השתמשו בסמלים שונים כדי להראות אילו משתמשים ב-Play Games הם כבר חברים, ואילו משתמשים עדיין לא חברים ב-Play Games אבל נכנסו לחשבון באמצעות Play Games.
משתמשים בשני סמלים למשתמשי Play Games, אחד ל'חברים' ואחד ל'לא חברים' (או כשסטטוס החברות לא ידוע).
![]() |
4.3 | שיטה מומלצת | תתקשר אל loadFriends() בכל פעם שמתחברים ותציג את רשימת החברים כדי לוודא שהיא עדכנית. מוודאים שהשחקנים רואים את הרשימה המעודכנת.
|
4.4 | שיטה מומלצת | אם במשחק שלכם כבר יש חברים, אתם יכולים להשתמש ב-Friends APIs כדי להוסיף את החברים ב-Play Games לרשימת החברים. אם שחקן מופיע ברשימת החברים במשחק וגם ברשימת החברים ב-Play Games, יוצג הסמל 'חברים'. |
4.5 | שיטה מומלצת | אם שחקן דחה את הבקשה לגשת לרשימת החברים שלו, אל תציגו שוב את תיבת הדו-שיח שמבקשת גישה, אלא אם המשתמש ביצע פעולה שמצביעה על כך שהוא רוצה לתת גישה (לדוגמה, לחיצה על הלחצן 'ייבוא חברים מ-Play Games'). |
4.6 | שיטה מומלצת | אם שחקן מסוים סירב לאפשר גישה לרשימת החברים, צריך לספק לו דרך לאפשר גישה לרשימת החברים בעתיד (לדוגמה, אחרי לחיצה על הלחצן 'ייבוא חברים מ-Play Games'). |
4.7 | שיטה מומלצת | אם אתם משתמשים במזהה השחקן או ברשימת החברים עם שרת קצה עורפי, אתם חייבים לגשת למזהה או לרשימה באופן מאובטח.
בנוסף, במשחקים ישנים יותר ובקרב שחקנים מסוימים, יכול להיות שמזהה השחקן שמוחזר על ידי Android SDK עבור שחקן מסוים לא יהיה זהה למזהה ששחקנים אחרים רואים כשהם צופים בשחקן הזה באותו משחק. זה רלוונטי במיוחד כשמשתמשים ברשימת החברים. עם זאת, הערך player_id
שמוחזר ב-REST API תמיד עקבי, ותמיד זהה למזהה
ששחקנים אחרים רואים.
|
5. מכסות והגבלת קצב של יצירת בקשות
רשימת המשימות הבאה רלוונטית לניהול המכסה והגבלת הקצב במשחק שלכם. במאמר ניהול מכסות והגבלת קצב מוסבר איך לנהל את המכסה של המשחק ולזהות מתי חורגים ממגבלת הקצב.
מזהה | חשיבות | תיאור |
---|---|---|
5.1 | שיטה מומלצת |
שימוש בספריות לקוח.
ספריות הלקוח לנייד משתמשות במספר אסטרטגיות כדי לצמצם את מספר הקריאות לשירות. לדוגמה, נתונים של הישגים וטבלאות הישגים נשמרים במטמון, כך שהשחקנים יכולים לראות את ההישגים שלהם כמה פעמים שהם רוצים בלי שהשירות יצטרך לבצע כמה קריאות. ספריית הלקוח של Android לא תשלח את הניקוד של השחקן לשרת אם הניקוד לא טוב כמו ניקוד שהגשתם לאחרונה. ספריית Android גם משלבת באופן אוטומטי קריאות תכופות להגדלת ההישגים כשהיא מזהה שמוגבלת לכם מהירות השליחה. |
5.2 | מומלץ |
לשלב שיחות תכופות עם הישגים מצטברים.
אם אתם יוצרים משחק לחימה ויש בו הישג 'הנחתת 5,000 אגרופים', אל תשלחו קריאה להגדלת ערך ההישג בכל פעם שמישהו מניח אגרוף. צריך לחכות עד סוף הסיבוב ואז לשלוח קריאה אחת של |
5.3 | מומלץ |
חשוב להיות מודעים לשימוש שלכם.
חשוב לשים לב למספר הקריאות שאתם מבצעים אל Google Play Games Services. גם אם לא חורגים ממגבלות הקצב, ביצוע שיחות בתדירות גבוהה עלול להוביל לתנועת רשת גבוהה ולגרום לסוללה של המכשיר להתרוקן מהר יותר. כדי להימנע מכך, אפשר להשתמש בטכניקות הבאות:
|
6. משחקים שמורים
רשימת המשימות הבאה רלוונטית להטמעה של התכונה משחקים שמורים במשחק שלכם.
מזהה | חשיבות | תיאור |
---|---|---|
6.1 | חובה |
מוסיפים מטא-נתונים כדי לספק הקשר נוסף למשחקים השמורים.
כששומרים משחק, צריך לכלול לפחות את המטא-נתונים הבאים:
|
6.2 | חובה |
מאפשרים לשחקנים לטעון משחקים שמורים.
טוענים את המשחק השמור הנכון כששחקנים בוחרים מתוך אפליקציית Play Games או ממשק המשתמש של ברירת המחדל לבחירת משחקים שמורים. |