השלב הראשון בשילוב המשחק עם Google Play Games Services (PGS) הוא הטמעה של אימות פלטפורמה. השלב הזה נדרש כדי לגשת לכל שאר התכונות, כמו הישגים, טבלאות מובילים ואירועים.
Play Games Services SDK מבצע אוטומטית אימות בפלטפורמה בהפעלת המשחק, ולכן צריך לשלב את PGS v2 SDK במשחק ולהטמיע את זרימת האימות המומלצת. כך המשחק יהיה מוכן להטמעה ולעמידה בהנחיות לחוויית המשתמש של Google Play Games Level Up.
מושגי אימות
ב-Play Games Services v2, המושג 'כניסה לחשבון' מחולק לשתי שכבות נפרדות: אימות בפלטפורמה ואימות במשחק.
אימות בפלטפורמה
Play Games Services מספק שכבת מעורבות בפלטפורמה. הוא מנהל את הקשר של השחקן עם המערכת האקולוגית של Google Play Games באמצעות פרופיל הגיימר, כדי לגשת לתכונות כמו הישגים, לוחות הישגים ומשימות. אלה המאפיינים העיקריים של אימות פלטפורמה:
- שקט ואוטומטי: האימות מתבצע אוטומטית ברקע כשהמשחק מופעל. בשירותי Play Games לא נדרש לחצן כניסה ידנית.
- מזהה שחקן: אחרי אימות מוצלח בפלטפורמה, Play Games Services מספק מזהה שחקן יציב. המזהה הזה זהה בכל המכשירים עבור אותו משחק. המזהה הזה משמש בעיקר למעקב אחרי תכונות של הפלטפורמה, כמו התקדמות בהשגת הישגים.
- הפרדה: אסור להשתמש ב-Play Games Services כמערכת הזהויות הראשית של המשחק לניהול החשבון של השחקן במשחק (IGA), ההתקדמות במשחק או המלאי. Play Games Services משמש כמזהה פלטפורמה קבוע.
מזהה שחקן
מזהה השחקן הוא המזהה של חשבון השחקן ב-Play Games Services. המשחק יכול לאחזר את המזהה של כל שחקן שנכנס למשחק באמצעות אימות של Play Games Services. השילוב של לקוח המשחק, השילוב של שרת הגיימינג ושירות השמירה בענן יכולים להשתמש במזהה כדי לגשת בצורה מאובטחת לנתוני השחקן מ-Play Games Services.
מזהה השחקן נשאר זהה עבור משתמש מסוים כשהוא משחק במשחק שלכם בכמה מכשירים. עם זאת, לא תמיד יש עקביות בין המשחקים. מידע נוסף זמין במאמר בנושא מזהי שחקנים מהדור הבא.
אימות במשחק
אתם מנהלים את החשבון במשחק (IGA), שהוא מערכת הזהויות שמקשרת בין ההתקדמות של השחקן, המלאי והמטבע במשחק שלכם.
- זהות ראשית: אתם יכולים להשתמש בקצה העורפי שלכם, בתכונה 'כניסה באמצעות חשבון Google' (SiWG) או בספקים אחרים כשיטת הכניסה העיקרית.
- עצמאות: שחקנים יכולים להיכנס ל-Play Games Services (זהות פלטפורמה) כדי לזכות בהישגים בזמן שהם מחוברים לכל IGA ספציפי (לדוגמה, חשבון אורח או חשבון SiWG ספציפי).
- ניהול של כמה מזהי משתמשים במשחקים: Play Games Services מטפלים רק באימות הפלטפורמה. המשחק שלכם מנהל את האימות הראשי של השחקנים בחשבונות המשחקים שלהם. המשמעות היא שאין שינוי בתהליכים הקיימים במשחק שמאפשרים לשחקנים לעבור בין הרכישות מתוך האפליקציה. כששחקנים מחליפים חשבונות, הם נשארים מאומתים בפלטפורמת Play Games דרך PGS, ואתם ממשיכים לשלוח את הנתונים שלהם שקשורים להישגים ולתכונות אחרות של PGS באמצעות מזהה השחקן הקבוע.
המשכיות בפלטפורמות שונות עם SiWG
כדי לעזור לשחקנים להעביר את ההתקדמות שלהם בין מכשירי Android, iOS ואינטרנט, מומלץ להשתמש בכניסה באמצעות חשבון Google כשיטת האימות העיקרית במשחק. כמה נקודות שכדאי לזכור:
- כפתור לכניסה באמצעות חשבון Google: ב-PGS v1, הכפתור Google Play טיפל לעיתים קרובות בכניסה לפלטפורמה ולמשחק. בגרסה 2, אלה תהליכים נפרדים. כדאי להטמיע כפתור סטנדרטי של כניסה באמצעות חשבון Google כדי לאפשר לשחקנים לאמת את הזהות שלהם ולגשת לחשבון שלהם ב-IGA.
- Google Sign-in SDKs:
- ב-Android וב-iOS, משתמשים בערכות ה-SDK הרגילות של Google Sign-in כדי לאמת את השחקנים במשחקים המיידיים שלהם.
- שימוש ב-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.
הפסקת ההנחיות ליצירת פרופיל שמופעלות אוטומטית
כדי להשבית את ההנחיות ליצירת פרופיל בהפעלה, צריך להגדיר את קובץ המניפסט כך שההנחיות לא יופעלו אוטומטית. כך המשתמשים שאין להם פרופיל Play Games Services יוכלו להמשיך לטעון את המשחק בלי לקבל בקשה ליצור פרופיל Play Games Services.
המשתמשים יכולים להיכנס באמצעות כל ספק זהויות, אבל כדאי להציג הנחיה ליצירת פרופיל כדי לעודד אותם לבצע אימות באמצעות מערכת האימות של Play Games Platform. אתם יכולים להציג את ההנחיה הזו מתי שתרצו, אבל חשוב לוודא שהיא מוצגת לפני שהמשתמשים מתקדמים באופן משמעותי בתכונות כמו הישגים וטבלאות מובילים.
כדאי להציג את ההנחיה ליצירת פרופיל ברגעים המומלצים הבאים:
- אחרי שמשלימים מדריך.
- במהלך רגע מתגמל (לדוגמה, ניצחון במשחק, איסוף פריט נדיר או הגעה לאבן דרך).
- בזמן הפעלת סשן שני.
מידע נוסף זמין במאמרים מניעת הפעלה אוטומטית של יצירת פרופיל (Java) ומניעת הפעלה אוטומטית של יצירת פרופיל (Unity).
אימות במשחק
אחרי שהאימות של הפלטפורמה יסתיים בהצלחה, המפתחים צריכים לבצע את השלבים הבאים כדי שהשחקנים יוכלו לגשת לפריטים הווירטואליים במשחק, בהתאם למצב הנוכחי של המשחק:
- אם יש סשן משחק פעיל במכשיר, מאפשרים לשחקן להמשיך את הסשן הנוכחי.
- אם אין סשן פעיל של משחק:
- במקרה של שחזור חלק שבו משחק IGA אחרון ששוחק משויך למזהה הנגן של PGS, המערכת תמשיך לשחזר באופן אוטומטי את משחק ה-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. הם כוללים תרחישים למשתמשים חדשים, למשתמשים קיימים ולמשתמשים חוזרים, וגם למצב אורח.
שחקן חדש
התהליך הזה מתייחס למשתמש שמפעיל את המשחק בפעם הראשונה במכשיר שאין בו היסטוריית הפעילות ב-Play קודמת.
- בזמן ההפעלה, PGS SDK מאותחל כדי לאמת את זהות המשתמש בפלטפורמה (מזהה השחקן ב-PGS).
- אחרי תהליך ההתחברות הזה ברקע, המשחק מציג לשחקן אפשרויות ליצירת חשבון IGA, למשל יצירת חשבון חדש, כניסה באמצעות חשבון Google או שיטות אחרות לכניסה באמצעות רשתות חברתיות.
- אחרי שהשחקן יוצר או בוחר מזהה IGA, המשחק מקשר את החשבון הזה למזהה הראשי שנבחר בקצה העורפי.
- המשחק גם מקשר את מזהה ה-IGA שנבחר למזהה השחקן ב-PGS, ומסמן אותו כמזהה ה-IGA האחרון שהמשחק הופעל איתו לצורך שחזור חלק.
שחקנים עם סשנים פעילים
בתרחיש הזה מתואר מצב שבו שחקנים מפעילים את המשחק במכשיר שבו כבר יש להם סשן פעיל. המטרה היא לספק חוויית כניסה חלקה.
- כשהשחקן מפעיל את האפליקציה, מתבצע אימות שקט של PGS ברקע, ומסופק לכם מזהה שחקן כדי לעקוב אחרי ההתקדמות ביחס להישגים ולתכונות אחרות של Play Games.
- במקביל, במקרים הרלוונטיים, המשחק מדלג על מסכי הכניסה ומכניס את השחקן באופן מיידי לסשן הפעיל של IGA או לסשן האחרון של IGA שמשויך למזהה השחקן שלו, כדי שהוא יוכל להמשיך לשחק באופן מיידי.
שחקנים שמחליפים חשבונות
התהליך הזה מתרחש כששחקן עם סשן פעיל עובר להגדרות המשחק כדי להחליף חשבונות. לדוגמה, יציאה מחשבון ראשי כדי להשתמש בחשבון חלופי.
- השחקן מתנתק מה-IGA הנוכחי, אבל החיבור לפלטפורמת PGS נשאר פעיל.
- כשהשחקן מתחבר באמצעות חשבון IGA אחר, המשחק מקשר את החשבון החדש למזהה השחקן הנוכחי ב-PGS בתור חשבון ה-IGA האחרון ששיחק בו, רק כדי לאפשר שחזור חלק.
שחזור חלק לשחקנים חוזרים
התרחיש הזה רלוונטי כששחקן מפעיל את המשחק אחרי תקופה של חוסר פעילות, אחרי התקנה מחדש או במכשיר חדש לגמרי. מומלץ להטמיע במשחק שחזור חלק.
- בזמן ההפעלה, מערכת PGS מאמתת את המשתמש ומספקת למשחק את מזהה השחקן ב-PGS.
- המשחק בודק את ה-backend שלו (או את טוקן הזיכרון שאוחזר אם משתמשים ב-Recall API) כדי לראות אם חשבון IGA של משחק אחרון ששוחק כבר מקושר למזהה PGS הזה.
- אם נמצא קישור, המשחק משחזר אוטומטית את ההתקדמות של השחקן ומבצע התחברות, בלי להציג את מסך ההתחברות הידנית.
- אחרת, המשחק מציג לשחקן את מסך הכניסה שלו
- השחקן בוחר שיטת כניסה ונכנס לחשבון IGA
- לאחר מכן המשחק מקשר את ה-IGA הזה למזהה השחקן ב-PGS בתור ה-IGA האחרון שהופעל, כדי לאפשר שחזור חלק.
מצב אורח
השחקנים יכולים להפעיל את המשחק ולשחק בו באמצעות חשבון אורח מקומי. שירותי Play Games עדיין מאמתים את השחקן ברקע. אם השחקן בוחר באפשרות שמירת ההתקדמות, המשחק ממיר את סשן האורח למזהה גיימר קבוע ומקשר אותו למזהה השחקן. מידע נוסף על פתרון בעיות שקשורות לחשבונות בעלי מאפיינים זהים לחשבונות פעילים זמין במאמר חשבון אורח.
