כדי לשלב את המשחק עם 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.
הנחיה ליצירת פרופיל כשמפעילים משחק (לחצו כדי להגדיל). השבתת ההנחיות ליצירת פרופיל בהפעלה והוספת הנחיות ידניות אחרי אתחול המשחק אפשר להשבית את ההנחיות ליצירת פרופיל שמופעלות אוטומטית דרך קובץ המניפסט. כך המשתמשים שאין להם פרופיל Play Games Services יוכלו להמשיך עם שיטות האימות שהטמעתם בלי לקבל מיד בקשה ליצור פרופיל Play Games Services.
המשתמשים יכולים להיכנס באמצעות כל ספק זהויות, אבל מומלץ להציג הנחיה ליצירת פרופיל Get the authentication result כדי לעודד הרשמה ל-Play Games Platform. אתם יכולים להציג את ההנחיה הזו מתי שתרצו, אבל חשוב לוודא שהיא מוצגת לפני שהמשתמשים מתקדמים באופן משמעותי בתכונות כמו הישגים וטבלאות מובילים.
כדאי להציג את ההנחיה ליצירת פרופיל ברגעים המומלצים הבאים:
- אחרי שמסיימים לקרוא את המדריך.
- במהלך רגע מתגמל (לדוגמה, ניצחון במשחק, איסוף פריט נדיר או הגעה לאבן דרך).
- בזמן הפעלת סשן שני.
תהליך האימות המומלץ
כדי לעמוד בהנחיות 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. מידע נוסף זמין במאמר בנושא ניהול המכסה היומית.