כדי לשלב את המשחק עם Google Play Games Services, קודם צריך להטמיע אימות פלטפורמה. השלב הזה נדרש כדי לגשת לכל שאר התכונות, כמו הישגים, טבלאות מובילים ואירועים.
כדי לעמוד בהנחיות לחוויית המשתמש של Google Play Games Level Up, המשחק צריך להתאים לזרימת האימות המומלצת.
הפעלה ואימות
זהו שלב חובה לאתחול ולאימות של המשחק:
- כדי להטמיע אימות בפלטפורמה, צריך לאתחל את Play Games Services v2 SDK בהפעלה. מידע נוסף זמין במאמר בנושא אימות הפלטפורמה במשחקים ל-Android. זהו שלב חובה כדי לגשת לתכונות של Play Games Services, כמו הישגים וטבלאות מובילים.
- האימות פועל כתהליך שקט ברקע במהלך הפעלת המשחק.
משתמשים קיימים ב-Play Games Services יראו הודעת פתיחה אחרי אימות מוצלח.
יצירת פרופיל
שחקנים צריכים פרופיל ב-Play Games Services כדי להשתמש בפלטפורמה. יכול להיות שלחלק מהשחקנים לא יהיה פרופיל ב-Play Games Services כשהם יתחילו לשחק במשחק שלכם. השחקנים האלה יתבקשו ליצור חשבון.
ההנחיות ליצירת פרופיל מופעלות אוטומטית כברירת מחדל כשמפעילים משחק ללא פרופיל Play Games Services.
תהליך האימות המומלץ
כדי לעמוד בהנחיות Level Up של Google Play Games בנושא שיפור חוויית המשתמש, עליכם לוודא שאתם עומדים בדרישות בנושא המשכיות של השחקן. כדי שהשחקנים יוכלו להיכנס למשחק שלכם, אתם צריכים להשתמש בתהליך האימות הבא:
- במהלך רצף ההפעלה של המשחק, מטמיעים את יצירת הפרופיל שמופעלת אוטומטית.
- אם האימות האוטומטי נכשל או שאתם דוחים אותו, צריך להציג כפתור להתחברות ידנית כדי שתוכלו להתאמת אחר כך.
מזהה שחקן
מזהה השחקן הוא המזהה של חשבון השחקן ב-Play Games Services. המשחק יכול לאחזר את המזהה של כל שחקן שנכנס למשחק באמצעות אימות של Play Games Services. השילוב של לקוח המשחק, השילוב של שרת הגיימינג ושירות השמירה בענן יכולים להשתמש במזהה כדי לגשת בצורה מאובטחת לנתוני השחקן מ-Play Games Services.
מזהה השחקן נשאר זהה עבור משתמש כשמשחקים במשחק שלכם בכמה מכשירים. עם זאת, לא תמיד יש עקביות בין המשחקים. מידע נוסף זמין במאמר בנושא מזהי שחקנים מהדור הבא.
היקפי ההרשאות של OAuth
שירותי Play Games Services מסתמכים על מערכת OAuth כדי לאפשר לשחקנים לתת למשחק שלכם גישה לחשבון שלהם. לשירותי Play Games Services יש היקף ייחודי למשחקים (games-lite), והם מסתמכים על היקף אחר (drive.appdata) אם המשחק שלכם משתמש בתכונה של משחקים שמורים. התכונה "משחקים שמורים" מאפשרת גישה לחשבון Google Drive של המשתמש, שבו מאוחסנים נתוני המשחק.
כשמשתמשים ב-SDK של Play Games Services בגרסה 2, אפשר לבקש היקפי הרשאות נוספים של OAuth.
אם אתם צריכים היקפי הרשאות OAuth נוספים, מומלץ לקרוא ל-requestServerSideAccess.
מידע נוסף זמין במאמרים בנושא קבלת קוד אימות לשרת או אחזור קודי אימות לשרת.
מספר שירותי אימות
שירותי Play Games Services מספקים זהות גיימינג לשחקנים ב-Android, אבל זו לא חייבת להיות הזהות היחידה שמקושרת למשתמשים שלכם. אתם יכולים לאמת שחקנים באמצעות Play Games Services, מזהה של רשת חברתית ומערכת מזהים משלכם במשחק, והכול בו-זמנית.
Recall API
Recall API מאפשר למשחקים לנהל קישורים בין משתמשי PGS לבין החשבונות שלהם במשחק, על ידי שמירת טוקנים של זיכרון בשרתי Google. מידע נוסף על הפעלת התכונה הזו זמין במאמר שילוב של PGS Recall API במשחק.
שילוב של לקוח משחק
כשמשלבים אימות בפרויקט המשחק, מומלץ להשתמש בתהליך הבא למשתמש:
במהלך רצף ההפעלה של המשחק, נפתח חלון ליצירת פרופיל והמערכת מנסה לאמת את המשתמש או ליצור חשבון חדש.
אם האימות האוטומטי נכשל או שאתם דוחים אותו, צריך להציג כפתור להתחברות ידנית כדי שתוכלו לבצע אימות מאוחר יותר.
למידע על שילוב האימות בפרויקט המשחק, אפשר לעיין במסמכים לפי סוג הפרויקט:
שילוב שרת גיימינג
אפשר לקבל קוד הרשאה לשרת על ידי קריאה ל-requestServerSideAccess
אחרי שמוודאים שהשחקן מאומת. מעבירים את קוד ההרשאה של השרת לשרת הגיימינג בק-אנד של המשחק כדי לתקשר ישירות עם השרתים של Play Games Services. התקשורת הזו מאפשרת לשרת שלכם לגשת לנתוני השחקנים, כולל:
- מזהה שחקן
- פרופיל
- רשימת חברים
- התקדמות במשחק
- הישגים
לאחר מכן השרת משתמש בקוד ההרשאה הזה עם API בארכיטקטורת REST כדי ליצור אינטראקציה מאובטחת עם שרתי Play Games Services. מידע נוסף זמין במאמר גישה ל-Play Games Services בצד השרת.
מכסת בקשות להתחברות
יש מכסה יומית לבקשות התחברות באמצעות Play Games Services. מידע נוסף זמין במאמר ניהול המכסה היומית.