סקירה כללית על ההעברה

שירותי Google Play Games,‏ SDK בגרסה Games v1 מסתמך על הכניסה לחשבון 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 שונות. במסמך הזה יש גם השוואה בין התכונות של האפליקציה לבין התכונות של גרסה 1 וגרסה 2 של Play Games Services SDK.

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

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

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

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

בטבלה הזו מוצגת השוואה בין התכונות של SDK בגרסה Games v1 ו-SDK בגרסה Games v2:

תכונה	‫ 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. קוד נוסף לטיפול בקוד סטנדרטי לצורך כניסה אוטומטית וטיפול בשגיאות.	נעשה שימוש ב-GamesSignInClient. ה-SDK מטפל בקוד סטנדרטי, בכניסה אוטומטית ובטיפול בשגיאות.
חלון קופץ של הודעת ברוכים הבאים	נדרש קוד נוסף. מפתחים יכולים לשלוט במיקום ובזמן ההצגה של המודעה.	אין צורך בקוד נוסף. ממשק משתמש עקבי בכל המשחקים שהוגדרו באמצעות SDK בגרסה Games v2.
יחסי תלות	נדרשת ההרשאה play-services-auth.	מודול המשחקים מטפל בהרשאה ובאימות. אין צורך להוסיף תלות נוספת.
יציאה מהחשבון	נעשה שימוש ב- .GoogleSignInClient.signOut	אין תמיכה ב-API של יציאה מהחשבון.
כמה חשבונות ב-Play Games Services והגדרות לכל משחק	אפשר לנהל את החשבון במשחק.	משתמשים יכולים לשנות את הפרופיל של Play Games Services בהגדרות של המכשיר הנייד. מידע נוסף זמין במאמר בנושא החלפת פרופילים של Play Games בנייד.