הגדרת שירותי המשחקים של 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 שמתכננים להשתמש בהם בפרויקט.

מסוף

הפעלת ה-API של Google Play Game Services

gcloud 

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

כניסה ל-Play Console

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

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

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

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

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

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

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

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

    • שימוש בפרויקט קיים של Play Games Services: אם רוצים להשתמש בפרויקט קיים, בוחרים באפשרות הזו. תוצג לכם רשימה של פרויקטים של Play Games Services שקיימים בחשבון שלכם. בוחרים את פרויקט המשחק מהרשימה ולוחצים על שימוש. זו לא בחירה שכיחה, אבל אתם יכולים להשתמש בה אם אתם יוצרים משחק חדש ב-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 כדי להוסיף אמצעי אימות ולקשר את מזהה הלקוח למשחק.

פירוט השלבים:

אם עדיין לא הגדרתם את מסך ההסכמה k-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). תיפתח תיבת דו-שיח עם קישורים עמוקים והוראות ליצירת מזהה לקוח OAuth ב-Google Cloud Platform.

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

  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 ידפיס את טביעת האצבע במסוף.

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

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

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

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

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

שרת הגיימינג

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

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

הגדרת הרשאה

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

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

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

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

הרצת בדיקות

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. הגדרת המשחק באמצעות Play Console
אם יצרתם מזהה לקוח OAuth 2.0 לאפליקציה שלכם ב-Google Cloud Console, שירותי Google Play Games Services לא יקשרו בין ההישג וטבלאות המובילים של המשחק לבין מזהה הלקוח. כדי ליצור את השיוך הזה, צריך ליצור פרטי כניסה באמצעות מזהה לקוח OAuth 2.0, כמו שמתואר במאמר יצירת פרטי כניסה.
2. שימוש במזהה האפליקציה הנכון ב-Android
מזהה האפליקציה הוא משאב מחרוזת שחובה להפנות אליו במניפסט של Android. מחרוזת מזהה האפליקציה מורכבת רק מהספרות (בדרך כלל 12 או יותר) שבתחילת מספר הלקוח שמופיע ב-Play Console. מזהה האפליקציה מופיע בחלק העליון של הדף הגדרות אישיות, ומתחת לשם המשחק הוא מסומן כמזהה פרויקט.
3. חתימה על ה-APK באמצעות האישור הנכון
כשמקשרים את אפליקציית Android למשחק ב-Play Console, צריך להשתמש בדיוק באותו שם חבילה ובאותה טביעת אצבע לאישור שהשתמשתם בהם כדי לפרסם את האפליקציה. אם אין התאמה, הקריאות ל-Google Play Games Services ייכשלו. צריך ליצור שני מזהי לקוח, אחד עם טביעת האצבע לאישור הגרסה ואחד עם טביעת האצבע לאישור ניפוי הבאגים. בשניהם חשוב להשתמש באותו שם חבילה. מידע נוסף על הגדרת אישור החתימה ב-Play Console זמין במאמר בנושא חתימה על אפליקציות.
4. כשמפתחים למערכת Android, צריך לכלול את ה-SDK של Play Games כפרויקט ספריה ולא כ-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 Games Services.
7. בשלב ההשקה, פרסמו קודם את ההגדרות של Play Games Services לפני פרסום המשחק.
יכול להיות שמפתחים יפרסמו את האפליקציה שלהם בטעות בלי לפרסם את ההגדרות התואמות של Play Games Services לאפליקציה. כתוצאה מכך, יכול להיות ששחקנים שמבצעים אימות באמצעות חשבונות שהם לא חשבונות בודקים ייתקלו בשגיאות, כי האפליקציה לא יכולה להפנות להגדרות הנכונות של המשחק. כשמפרסמים את המשחק, חשוב לזכור קודם לפרסם את הגדרות המשחק באמצעות האפשרות פרסום המשחק ב-Play Console. כאן מוסבר איך לפרסם את השינויים במשחק.

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

השלבים הבאים

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