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