הגדרת שירותי המשחקים של Google Play

בדף הזה נסביר איך להגדיר את Google Play Games Services למשחק ל-Android באמצעות Google Play Console. Play Console הוא מקום מרוכז שבו אפשר לנהל את שירותי המשחקים ולהגדיר את המטא-נתונים שמשמשים להרשאה ולאימות של המשחק.

כדי להוסיף את המשחק ל-Play Console, פועלים לפי השלבים הכלליים הבאים:

  • יוצרים פרויקט משחק למשחק ומציינים פרטים כמו השם והתיאור של המשחק.

  • יוצרים ומקשרים את פרטי הכניסה הנדרשים כדי לאשר ולאמת את המשחק ב-Google Play Games Services.

לפני שמתחילים

לפני שמגדירים את Google Play Games Services, צריך להשלים את השלבים הבאים.

יצירת חשבון פיתוח ב-Google Play

יצירת פרויקט ב-Google Cloud

צריך להגדיר פרויקט ב-Google Cloud. מידע נוסף זמין במאמר

כדי להשתמש ב-Play Console, צריך להפעיל את ממשקי ה-API שבהם אתם מתכננים להשתמש בפרויקט.

מסוף

הפעלת Google Play Games Services API

gcloud

gcloud services enable \
   --project "PROJECT" \
   "games.googleapis.com"

כניסה ל-Play Console

כדי להיכנס, עוברים אל Google Play Console. אם עדיין לא נרשמתם ל-Play Console, תתבקשו לעשות זאת.

הוספת המשחק ל-Play Console

כדי להוסיף את המשחק, פועלים לפי השלבים הבאים:

  1. ב-Play Console, יוצרים אפליקציה ומציינים שהיא משחק. למידע נוסף, קראו את המאמר יצירה והגדרה של האפליקציה.

  2. עוברים אל צמיחה > שירותי Play Games > הגדרה וניהול > הגדרה.

  3. מציינים אם המשחק כבר משתמש ב-Google APIs (כמו Firebase). חשוב לבחור באפשרות הנכונה, אחרת יכול להיות שתהיה בעיה במשחק בזמן השימוש ב-Google APIs. אלה האפשרויות:

    • לא, במשחק שלי לא נעשה שימוש ב-Google APIs: אם אתם יוצרים משחק חדש או אף פעם לא הגדרתם לו Google API, בוחרים באפשרות הזו. מזינים את שם המשחק ולוחצים על Create.

    • כן, המשחק שלי כבר עושה שימוש ב-Google APIs: בוחרים באפשרות הזו אם כבר הגדרתם Google API למשחק. במקרה כזה, תוצג לכם רשימה של הפרויקטים שלכם במסוף Google Cloud. בוחרים את הפרויקט מהרשימה ולוחצים על שימוש.

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

    נוצר פרויקט משחק של Play Games Services, ונוצרת עבורכם רשומה תואמת במסוף Google Cloud.

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

יצירת מזהה לקוח של OAuth 2.0

כדי שהמשחק יאומת ויקבל הרשאה לבצע קריאה ל-Google Play Games Services, צריך להקצות לו מזהה לקוח מסוג OAuth 2.0. כדי להגדיר פרטי כניסה ל-Play Games Services, שהם השיוך בין מזהה לקוח למשחק, צריך ליצור את מזהה הלקוח באמצעות Google Cloud Platform. לאחר מכן, משתמשים ב-Google Play Console כדי להוסיף פרטי כניסה ולקשר את מזהה הלקוח למשחק.

להוראות מפורטות יותר, יש לפעול לפי השלבים הבאים:

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

הודעה עם בקשה להגדרת מסך הסכמה ל-OAuth

לוחצים על Configure (הגדרה). תיפתח תיבת דו-שיח עם הוראות נוספות וקישור מעמיק אל Google Cloud Platform.

מופיעה בקשה להגדרת מסך ההסכמה של OAuth.

חשוב לוודא שמסך ההסכמה זמין לכל מי שהמשחק זמין לו. רשימת ההיקפים הסופית צריכה לכלול את games,‏ games_lite ו-drive.appdata. לא יהיה צורך באימות האפליקציה באף אחד מההיקפים האלה. מומלץ לפרסם את מסך ההסכמה באופן מיידי. אם זה לא אפשרי, תוכלו להציג את מסך ההסכמה למבחנים כדי לאפשר להם להיכנס למשחק.

אם השלמתם את ההגדרה של מסך ההסכמה של OAuth, לוחצים על סיום. Google Play Console מתעדכן באופן אוטומטי, ואם ההגדרה בוצעה בהצלחה תוכלו ליצור פרטי כניסה:

יצירת פרטי כניסה

יצירת פרטי כניסה

כדי לתת למשחק הרשאה לתקשר עם Google Play Games Services, צריך ליצור פרטי כניסה עם מזהה לקוח OAuth2 מורשה.

בקטע Credentials, לוחצים על Add credential.

בשלב הבא באשף, בוחרים אם ליצור פרטי כניסה ל-Android (אם קובץ ה-APK של המשחק יאמת את המשתמש וישתמש בממשקי ה-API של Play Games Services) או פרטי כניסה לשרת המשחק (אם שרת המשחק ישתמש בממשקי ה-API של Play Games Services). פועלים לפי ההוראות הספציפיות לסוג פרטי הכניסה הרצוי.

Android

הגדרת פרטי הכניסה

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

הגדרת הרשאה

בשלב הבא, בוחרים מזהה לקוח ב-OAuth לשימוש בפרויקט המשחק הזה. אם כבר יש לכם מזהי לקוחות ב-OAuth2, תוכלו לבחור אחד מהם. עם זאת, בדרך כלל יוצרים חשבון חדש. לוחצים על Create OAuth client. תיפתח תיבת דו-שיח עם קישורים מעמיקים והוראות ליצירת מזהה לקוח OAuth ב-Google Cloud Platform.

  1. בוחרים באפשרות Android בתור סוג האפליקציה.
  2. מזינים את שם המשחק בשדה שם.
  3. מזינים את שם החבילה של אפליקציית Android בשדה Package name.
  4. פותחים טרמינל ומריצים את הכלי Keytool כדי לקבל את טביעות האצבע מסוג SHA1 של אישורי השחרור והניפוי הבאגים.

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

    keytool -list -keystore <path-to-production-keystore> -v

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

    keytool -list -keystore <path-to-debug-keystore> -v הערה: ב-Windows, מאגר המפתחות לניפוי באגים נמצא ב-C:\Users\<USERNAME>\.android\debug.keystore. ב-Mac או ב-Linux, מאגר המפתחות לצורכי ניפוי באגים נמצא בדרך כלל ב-~/.android/debug.keystore.

  5. אופציונלי: אם יצרתם מאגר מפתחות חדש באמצעות Unity Hub, אל תיצרו אישור חדש לפי ההוראות בשלב הקודם. משתמשים בטביעת האצבע מסוג SHA1 שיצרתם ב-Unity.

    • משתמשים בפקודה הבאה כדי להדפיס את טביעת האצבע של SHA1 בטרמינל:

      keytool -list -keystore <var>path</var>/<var>name_of_keystore</var>.keystore -v

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

  7. מדביקים את טביעת האצבע של SHA1 בשדה טביעת אצבע של אישור החתימה (SHA1).

  8. לוחצים על יצירה.

מידע נוסף על OAuth 2.0 ב-Android זמין במאמר אימות לשירותי OAuth2.

אחרי שלוחצים על סיום בתיבת הדו-שיח, מספרי הלקוח הזמינים יתרעננו. בתפריט הנפתח, בוחרים את פרטי הכניסה שיצרתם ולוחצים על Save Changes. כך נוצרים פרטי הכניסה כטיוטה, ומאפשרים לבצע אימות ב-Play Games Services במשחק.

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

שרת משחק

הגדרת פרטי הכניסה

מוודאים שהשם בשדה שם זהה לשם המשחק.

הגדרת הרשאה

בשלב הבא, בוחרים מזהה לקוח ב-OAuth לשימוש בפרויקט המשחק הזה. אם כבר יש לכם מזהי לקוחות ב-OAuth2, תוכלו לבחור אחד מהם. עם זאת, בדרך כלל יוצרים חשבון חדש. לוחצים על Create OAuth client. תיפתח תיבת דו-שיח עם קישורים מעמיקים והוראות ליצירת מזהה לקוח OAuth ב-Google Cloud Platform.

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

מידע נוסף על OAuth 2.0 ב-Android זמין במאמר אימות לשירותי OAuth2.

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

הפעלת בדיקה

כדי לוודא ש-Google Play Games Services פועל בצורה תקינה במשחק, כדאי לבדוק את שירותי המשחק לפני שמפרסמים את השינויים במשחק ב-Google Play.

אם המשחק שלכם לא פורסם, תוכלו להוסיף את חשבונות המשתמשים של הבוחנים לרשימת ההיתרים כדי לתת להם גישה. אחרת, הבודקים יקבלו שגיאות OAuth ו-404 כשינסו לגשת לנקודות קצה של Play Games Services, כמו נקודת הקצה sign-in.

למשתמשים עם חשבונות בדיקה מורשים תהיה גישה לפרויקט המשחק שלכם ב-Play Games Services שלא פורסם, והם יוכלו לבדוק אם שירותי Play Games Services שהוגדרו פועלים כמו שצריך.

יש שתי דרכים לאפשר לבודקים להשתמש בממשקי ה-API של Play Games Services במשחק שלכם:

  • ברמת המשתמש, על ידי הוספה של כתובות אימייל ספציפיות.

  • ברמת הקבוצה, על ידי הפעלת שירותי Play Games במסלול הפצה ב-Play Console.

כדי להוסיף בודקים ספציפיים לפרויקט המשחק:

  1. פותחים את הכרטיסייה בודקים של המשחק ב-Google Play Console (פיתוח > Google Play Games Services > הגדרה וניהול > בודקים).
  2. לוחצים על הלחצן Add testers.
  3. בתיבת הדו-שיח שמופיעה, מזינים את כתובות האימייל של חשבונות Google שרוצים להוסיף כבודקים (מופרדות בפסיקים או כתובת אימייל אחת לכל שורה).
  4. לוחצים על הוספה כדי לשמור את המשתמשים בתור בודקים. חשבונות הבודקים שהוספתם אמורים לקבל גישה ל-Play Games Services תוך כמה שעות.

כדי לתת לקבוצה גישה לבדיקה, מפעילים מסלול הפצה כדי לתת לו גישה ל-Play Games Services:

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

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

  1. פותחים את הקטע בודקי PGS (צמיחה > שירותי Play Games > הגדרה וניהול > בודקים) ובוחרים בכרטיסייה נתיבי השקה. בדף הזה תוכלו לראות גם את רשימת הטראקים שכבר מופעלים לבדיקה של שירותי Play Games.
  2. לוחצים על הוספת טראקים.
  3. בוחרים טראק אחד או יותר להפעלה לצורך בדיקה של שירותי המשחקים של Play.
  4. לוחצים על הוספת טראקים.

טראקי המשחקים שנבחרו יופיעו עכשיו ברשימת הטראקים שמופעלים לבדיקה בשירותי Play Games.

התכונה הזו זמינה רק אם יש לכם אפליקציה ל-Android שמקושרת למשחק ב-Google Play Console.

איך למנוע בעיות נפוצות

כדי להימנע משגיאות נפוצות בהגדרה, חשוב לפעול לפי ההמלצות הבאות כשמגדירים את המשחק לשימוש בשירותי Google Play Games.

1. הגדרת המשחק באמצעות Play Console
אם יצרתם מזהה לקוח Oauth 2.0 לאפליקציה במסוף Google Cloud, שירותי Google Play Games לא ידעו על השיוך בין ההישגים והלוחות המובילים של המשחק לבין מזהה הלקוח. כדי ליצור את השיוך הזה, צריך ליצור פרטי כניסה באמצעות מזהה הלקוח של OAuth 2.0, כפי שמתואר במאמר יצירת פרטי כניסה.
2. שימוש במזהה האפליקציה הנכון ב-Android
מזהה האפליקציה הוא משאב מחרוזת נדרש שצריך להפנות אליו במניפסט של Android. מחרוזת מזהה האפליקציה מורכבת רק מהספרות (בדרך כלל 12 או יותר) שמופיעות בתחילת מזהה הלקוח שסופק על ידי Play Console. מזהה האפליקציה מופיע בחלק העליון של הדף Configuration, עם הכיתוב Project ID מתחת לשם המשחק.
3. חותמים על קובץ ה-APK באמצעות האישור הנכון
כשמקשרים את אפליקציית Android למשחק ב-Play Console, צריך להשתמש באותו שם חבילה ובאותו טביעת אצבע של אישור שבהם השתמשתם כדי לפרסם את האפליקציה. אם יש אי-התאמה, הקריאות ל-Google Play Games Services ייכשל. צריך ליצור שני מזהי לקוח, אחד עם טביעת האצבע של אישור הגרסה ועוד אחד עם טביעת האצבע של אישור ניפוי הבאגים, ולהשתמש באותו שם חבילה בשניהם. למידע נוסף על ציון אישור החתימה ב-Play Console, אפשר לעיין במאמר חתימה על האפליקציות.
4. כשמפתחים ל-Android, צריך לכלול את Play Games SDK כפרויקט ספרייה, ולא כקובץ JAR עצמאי.
חשוב לוודא שערכת ה-SDK של Google Play Services מופיעה כפרויקט ספרייה בפרויקט Android שלכם. אחרת, יכול להיות שתופיעו שגיאות אם האפליקציה לא תמצא משאבים של Google Play Services. במאמר הגדרת Google Play Services מוסבר איך מגדירים את הפרויקט ל-Android כך שישתמש ב-Google Play Services.
5. כניסה באמצעות חשבון בדיקה במהלך הפיתוח
אם לא פרסמתם את השינויים בהגדרות המשחק ב-Play Console, ייתכן שתבחינו בשגיאות במהלך הבדיקה אם לא נכנסתם לחשבון בודק שמופיע ברשימת ההיתרים. תמיד צריך להפעיל את חשבון בעל התוכן הדיגיטלי ב-Play Console לצורך בדיקה. במאמר הפעלת חשבונות לצורך בדיקה מוסבר איך מנהלים חשבונות של בודקים.
6. פרסום מסך ההסכמה ב-Google Cloud Platform
לפני פרסום האפליקציה ב-Play Console, מפרסמים את מסך ההסכמה ב-Google Cloud Platform. בלי השלב הזה, הקהל הציבורי לא יוכל להשתמש באף אחת מהתכונות של שירותי המשחקים של Play.
7. לפני השקת המשחק, מפרסמים את ההגדרות של שירותי Play Games
מפתחים עשויים לפרסם בטעות את האפליקציה שלהם בלי לפרסם את ההגדרות התואמות של Play Games Services לאפליקציה. כתוצאה מכך, שחקנים שנכנסים לחשבון שלהם ולא לחשבון של בודק עשויים להיתקל בשגיאות כי האפליקציה לא יכולה להפנות להגדרות המשחק הנכונות. כשאתם משחררים את המשחק, חשוב לזכור לפרסם קודם את הגדרות המשחק באמצעות האפשרות פרסום המשחק ב-Play Console. במאמר פרסום השינויים במשחק מוסבר איך לפרסם את השינויים.

טיפים נוספים זמינים במדריך לפתרון בעיות ב-Android.

השלבים הבאים

אחרי שתשלימו את משימות ההגדרה הראשונית שמתוארות למעלה, תוכלו להפעיל את התכונות של Play Games Services במשחק, כמו משחקים שמורים, לוחות לידרבורד והישגים.