סקירה כללית על מיגרציה

שירותי Google Play Games, גרסה 1 של ה-SDK למשחקים מסתמכת על התחברות באמצעות חשבון Google ל-Android, שהוצאה משימוש ותוסר מ-Google Play services Auth SDK ‏(com.google.android.gms:play-services-auth) בשנת 2025. אפליקציות חדשות של משחקים יכולות להשתמש בגרסה Games v1 עד 2025. הסרת הכניסה באמצעות חשבון Google גורמת לבעיות תלות באפליקציות משחקים קיימות. העברה של אפליקציות משחקים קיימות מ-games v1 SDK ל-games v2 SDK פותרת בעיות תלות שנוצרו בעקבות ההסרה של התחברות באמצעות חשבון Google.

המסמך הזה עוזר להבין את האינטראקציות בין אפליקציית המשחקים לבין ערכות SDK שונות. במסמך הזה יש גם השוואה בין התכונות של האפליקציה לבין התכונות של ערכות ה-SDK של משחקים בגרסה 1 ובגרסה 2 של Play Games Services.

אינטראקציות עם SDK

בתרשימים מוצגת האינטראקציה בין אפליקציית משחקים ב-Android, בין ליבת שירותי Google לנייד (GMS), בין Play Games Services ובין שרת משחקים של צד שלישי (3P). הוא מדגיש איך האפליקציה משתמשת בשירותי Google לאימות ולתכונות משחק, וגם איך היא מתקשרת עם מערכת נפרדת של צד שלישי.

משחקים גרסה 2 (נוכחית)

אינטראקציה בין אפליקציית משחקים ב-Android, ליבת GMS, Play Games Services ושרת גיימינג של צד שלישי (3P). (לוחצים כדי להגדיל).

משחקים גרסה 1 (מדור קודם)

אינטראקציה בין אפליקציית משחקים ב-Android, ליבת GMS, שירותי Play Games ושרת משחקים של צד שלישי (3P). (לוחצים כדי להגדיל).

בהמשך מופיעה סקירה כללית קצרה של הרכיבים וערכות ה-SDK:

• אפליקציית משחקים.
  • האפליקציה הזו מייצגת את אפליקציית המשחק של המשתמש שפועלת במכשיר Android.
  • הוא מכיל שני רכיבים עיקריים:
    • ‫games v1 או games v2 SDK. ערכת ה-SDK בצד הלקוח שאחראית על האינטראקציה עם Play Games Services.
    • ‫Auth SDK. ‫Google Play services Auth SDK אחראי לטיפול בתהליכי אימות והרשאה של משתמשים במשחקים בגרסה 1.
  • שני ה-SDK מתקשרים באמצעות AIDL (שפה להגדרת ממשקים ב-Android), מה שמצביע על דפוס תקשורת בין תהליכים או שירותים שונים.
• ‫GMS Core נקרא גם Google Play Services.
  • זו השכבה הקניינית של Google ב-Android.
  • אפליקציית המשחקים משתמשת בשני מודולים של GMS Core:
    • מודול המשחקים מספק תכונות ספציפיות למשחקים, כמו טבלאות מובילים, הישגים וניהול מצב המשחק.
    • Auth Module מטפל בפעולות של אימות והרשאה של משתמשים.
  • ערכות ה-SDK של Games ו-Auth באפליקציית המשחקים מתקשרות עם המודולים המתאימים באמצעות ממשקי AIDL, שמציינים תקשורת בין תהליכים (IPC).

• שער Play Games Services.
  • שער לוגי שמתווך בין התקשורת של GMS Core לבין השרת של Play Games Services.
  • מטפל בבקשות API, בטרנספורמציה של נתונים ובאימות של תקשורת השרת.
• שרת Play Games Services.
  • מייצג את שירותי הקצה העורפי של Play Games Services שאחראים לאחסון נתוני משחק, לניהול חשבונות משתמשים ולתכונות של ריבוי משתתפים.
• שער למשחקים של צד שלישי.
  • אם אפליקציית המשחקים שלכם עומדת בדרישות של אפליקציית צד שלישי (3P), ספריית הלקוח מתקשרת עם השרתים של Play Games Services דרך שרתי המשחקים של הצד השלישי.
  • המשמעות היא שהאפליקציה יכולה גם לבצע אימות אצל ספק שירות אחר.
• שרת משחקים של צד שלישי.
  • מייצג שרת חיצוני אופציונלי שאפליקציית המשחקים יכולה ליצור איתו אינטראקציה, בדרך כלל לצורך תכונות מותאמות אישית או ניהול נתונים.
  • התקשורת עם האפליקציה מתבצעת דרך שער המשחקים של צד שלישי.

השוואה בין תכונות

בטבלה הזו מוצג השוואה בין התכונות של SDK של משחקים בגרסה 1 ו-SDK של משחקים בגרסה 2:

תכונה	games v1 SDK	games v2 SDK
אימות	נדרש שילוב עם play-services-auth.	פשוט ויעיל, לא נדרש play-services-auth
הרשאה	קוד נוסף להצלחה, לכישלונות ולניסיונות חוזרים.	בניהול של ה-SDK
טוקן גישה לשרת	יכול לבקש היקפי הרשאות נוספים של OAuth 2.0 עם GoogleSigninClient. קוד נוסף לטיפול בשגיאות במהלך האימות.	יכול לבקש שלושה היקפי הרשאות בסיסיים של OAuth 2.0 עם GamesSignInClient כשמבקשים גישה בצד השרת ל-Play Games Services web APIs. מידע נוסף זמין במאמרים בנושא גישה ל-Play Games Services בצד השרת ו אחזור קודי אימות לשרת.
תהליך הכניסה	נעשה שימוש ב-GoogleSigninClient. קוד נוסף לטיפול בקוד שחוזר על עצמו (boilerplate) לאימות אוטומטי ולטיפול בשגיאות.	נעשה שימוש ב-GamesSignInClient. ה-SDK מטפל בקוד שחוזר על עצמו (boilerplate), באימות אוטומטי ובטיפול בשגיאות.
חלון קופץ של הודעת ברוכים הבאים	נדרש קוד נוסף. מפתחים יכולים לשלוט במיקום ובזמן ההצגה של המודעה.	לא נדרש קוד נוסף. ממשק משתמש עקבי בכל המשחקים שהוגדרו באמצעות SDK בגרסה Games v2.
תלויות	נדרשת ההרשאה play-services-auth.	מודול המשחקים מטפל בהרשאה ובאימות. אין צורך להוסיף יחסי תלות נוספים.
יציאה מהחשבון	נעשה שימוש ב- .GoogleSignInClient.signOut	API של יציאה מהחשבון אינו נתמך.
כמה חשבונות ב-Play Games Services והגדרות לכל משחק	אפשר לנהל את החשבון במשחק.	המשתמשים יכולים לשנות את הפרופיל של שירותי Play Games בהגדרות המכשיר הנייד. מידע נוסף זמין במאמר בנושא איך מחליפים בין פרופילים של Play Games בנייד.