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