Google Play Games Services, games v1 SDK מסתמך על Google Sign-In ל-Android, שיצאה משימוש ותוסר מ-Google Play services Auth SDK (com.google.android.gms:play-services-auth) בשנת 2025.
אפליקציות משחקים חדשות יכולות להשתמש בגרסה 1 של Games עד שנת 2025. הסרת הכניסה באמצעות חשבון Google יוצרת בעיות תלות באפליקציות משחקים קיימות. העברת אפליקציות משחקים קיימות מ-games v1 SDK ל-games v2 SDK פותרת בעיות תלות שנוצרו בעקבות ההסרה של 'כניסה באמצעות חשבון Google'.
המסמך הזה עוזר להבין את האינטראקציות בין אפליקציית המשחקים לבין ערכות SDK שונות. במסמך הזה מוצגת גם השוואה בין המאפיינים של האפליקציה לבין המאפיינים של ערכות ה-SDK של Play Games Services בגרסה 1 ובגרסה 2.
אינטראקציות של SDK
התרשימים מדגימים את האינטראקציה בין אפליקציית משחקים ב-Android, Google Mobile Services (GMS) Core, Play Games Services ושרת משחקים של צד שלישי (3P). מודגשת האופן שבו האפליקציה משתמשת בשירותי Google לאימות ולתכונות המשחק, תוך אינטראקציה עם מערכת נפרדת של צד שלישי.
games v2 (הנוכחית)
games v1 (דור קודם)
בהמשך מופיעה סקירה כללית קצרה של הרכיבים וערכות ה-SDK:
- אפליקציית Games
- זהו האפליקציה של המשחק של המשתמש שפועלת במכשיר 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 בגרסה 1 ובגרסה 2 של Play Games Services:
תכונה |
games v1 SDK |
games v2 SDK |
|---|---|---|
אימות |
נדרש שילוב עם play-services-auth. |
פשוטה ויעילה יותר, ללא play-services-auth
נדרש. |
הרשאה |
קוד נוסף להצלחה, לכשלים ולניסיונות חוזרים. |
מנוהל על ידי ה-SDK |
אסימון גישה לשרת |
יכול לבקש היקפי הרשאות נוספים של OAuth 2.0 באמצעות GoogleSigninClient.קוד נוסף לטיפול בשגיאות במהלך הכניסה. |
אסור להשתמש בטווחים נוספים. קוד נוסף עם קריאה חוזרת (callback) של הצלחה או כישלון עם serverAuthcode. |
תהליך הכניסה |
נעשה שימוש ב- GoogleSigninClient.קוד נוסף לטיפול בקוד סטנדרטי לכניסה אוטומטית ולטיפול בשגיאות. |
נעשה שימוש ב- GamesSignInClient.ה-SDK מטפל בקוד סטנדרטי, בכניסה אוטומטית ובטיפול בשגיאות. |
חלון קופץ עם הודעה על הגעה לדף |
נדרש קוד נוסף. למפתחים יש שליטה על המיקום והתזמון של המודעות. |
אין צורך בקוד נוסף ממשק משתמש עקבי בכל המשחקים שהוגדרו ב-PGS V2. . |
יחסי תלות |
נדרשת play-services-auth. |
אין תלות נפרדת ב- play-services-auth. |
| יציאה מהחשבון |
נעשה שימוש ב- GoogleSignInClient.signOut. |
אין תמיכה ב-Sign-out API. |
חשבונות מרובים ב-Play Games Services והגדרות לכל משחק |
בחירה וניהול של חשבונות לא זמינים. |
לכל משחק יש חשבון משלו בשירותי המשחקים של Play, שאפשר לנהל. כך תוכלו לבחור את החשבון שבו כל משחק ישתמש. |