אימות בפלטפורמה

השלב הראשון בשילוב המשחק עם 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 כמערכת הזהויות הראשית של המשחק לניהול החשבון של השחקן במשחק (IGA), ההתקדמות במשחק או המלאי. שירותי Play Games משמשים כמזהה פלטפורמה קבוע.

מזהה שחקן

מזהה השחקן הוא המזהה של חשבון השחקן ב-Play Games Services. המשחק יכול לאחזר את המזהה של כל שחקן שנכנס למשחק באמצעות אימות של Play Games Services. השילוב של לקוח המשחק, השילוב של שרת הגיימינג ושירות השמירה בענן יכולים להשתמש במזהה כדי לגשת בצורה מאובטחת לנתוני השחקן מ-Play Games Services.

מזהה השחקן נשאר זהה עבור משתמש שמשחק במשחק שלכם בכמה מכשירים. עם זאת, לא תמיד יש עקביות בין המשחקים. מידע נוסף זמין במאמר בנושא מזהי שחקנים מהדור הבא.

אימות במשחק

אתם מנהלים את החשבון במשחק (IGA), שהוא מערכת הזהויות שמקשרת בין ההתקדמות של השחקן, המלאי והמטבע במשחק שלכם.

• זהות ראשית: אתם יכולים להשתמש בקצה העורפי שלכם, בתכונה 'כניסה באמצעות חשבון Google' (SiWG) או בספקים אחרים כשיטת הכניסה העיקרית.
• עצמאות: שחקנים יכולים להיכנס ל-Play Games Services (זהות פלטפורמה) כדי להשיג הישגים בזמן שהם מחוברים לכל IGA ספציפי (לדוגמה, חשבון אורח או חשבון SiWG ספציפי).
• ניהול של כמה מזהי משתמשים במשחקים: Play Games Services מטפלים רק באימות הפלטפורמה. המשחק מנהל את האימות הראשי של השחקנים בחשבונות שלהם ב-IGA. המשמעות היא שאין שינוי בתהליכים הקיימים במשחק שמאפשרים לשחקנים לעבור בין הרכישות שלהם בתוך האפליקציה. כששחקנים מחליפים חשבונות, הם ממשיכים להיות מאומתים בפלטפורמת Play Games דרך PGS, ואתם ממשיכים לשלוח את הנתונים שלהם שקשורים להישגים ולתכונות אחרות של PGS, בהתאם למזהה השחקן הקבוע.

המשכיות בפלטפורמות שונות עם SiWG

כדי לעזור לשחקנים להעביר את ההתקדמות שלהם בין מכשירי Android,‏ iOS ואינטרנט, מומלץ להשתמש בכניסה באמצעות חשבון Google כשיטת האימות העיקרית במשחק. כדאי לשים לב לנקודות הבאות:

• לחצן הכניסה באמצעות חשבון Google: בגרסה 1 של PGS, הלחצן 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).

אימות במשחק

אחרי שהאימות של הפלטפורמה יסתיים בהצלחה, המפתחים צריכים לבצע את השלבים הבאים כדי שהשחקנים יוכלו לגשת לפריטים במשחק, בהתאם למצב הנוכחי של המשחק:

1. אם יש סשן משחק פעיל במכשיר, מאפשרים לשחקן להמשיך את הסשן הנוכחי.
2. אם אין סשן פעיל של משחק:
   1. במקרה של שחזור חלק שבו משחק IGA אחרון ששוחק משויך למזהה השחקן ב-PGS, המערכת תמשיך לשחזר אוטומטית את משחק ה-IGA המשויך.
   2. אחרת, מציגים לשחקן את מסך הכניסה או יצירת החשבון שמוגדר באפליקציה. השחקנים יכולים לבחור את שיטת האימות המועדפת כדי ליצור חשבון 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. הם כוללים תרחישים למשתמשים חדשים, קיימים וחוזרים, ולמצב אורח.

שחקן חדש

התהליך הזה מתייחס למשתמש שמפעיל את המשחק בפעם הראשונה במכשיר שאין בו היסטוריית משחק קודמת.

1. בזמן ההפעלה, ה-PGS SDK מאותחל כדי לאמת את זהות המשתמש בפלטפורמה (מזהה השחקן ב-PGS).
2. אחרי תהליך ההתחברות הזה ברקע, המשחק מציג לשחקן אפשרויות ליצירת חשבון IGA, למשל יצירת חשבון חדש, כניסה באמצעות חשבון Google או שיטות אחרות לכניסה באמצעות רשתות חברתיות.
3. אחרי שהשחקן יוצר או בוחר מזהה IGA, המשחק מקשר את החשבון הזה למזהה הראשי שנבחר בקצה העורפי שלו.
4. המשחק גם מקשר את מזהה ה-IGA שנבחר למזהה השחקן ב-PGS, ומסמן אותו כמזהה ה-IGA האחרון שהופעל לצורך שחזור חלק.

שחקנים עם סשנים פעילים

בתרחיש הזה מתואר מצב שבו שחקנים מפעילים את המשחק במכשיר שכבר יש בו סשן פעיל. המטרה היא לספק חוויית כניסה חלקה.

1. כשהשחקן מפעיל את האפליקציה, מתבצע אימות שקט של PGS ברקע, ומסופק לכם מזהה שחקן כדי לעקוב אחרי ההתקדמות ביחס להישגים ולתכונות אחרות של Play Games.
2. במקביל, במקרים הרלוונטיים, המשחק מדלג על מסכי הכניסה ומכניס את השחקן באופן מיידי לסשן הפעיל של המשחק המיידי או למשחק המיידי האחרון ששויך למזהה השחקן שלו, כדי שהוא יוכל להמשיך לשחק באופן מיידי.

שחקנים שמחליפים חשבונות

התהליך הזה מתרחש כששחקן עם סשן פעיל עובר להגדרות המשחק כדי להחליף חשבונות. לדוגמה, יציאה מחשבון ראשי כדי להשתמש בחשבון חלופי.

1. השחקן יוצא מהחשבון הנוכחי במשחק, אבל החיבור לפלטפורמת PGS נשאר פעיל.
2. כשהשחקן מתחבר באמצעות חשבון IGA אחר, המשחק מקשר את החשבון החדש הזה למזהה השחקן הנוכחי ב-PGS בתור חשבון ה-IGA האחרון ששיחק בו, רק כדי לאפשר שחזור חלק.

שחזור חלק לשחקנים חוזרים

התרחיש הזה רלוונטי כששחקן מפעיל את המשחק אחרי תקופה של חוסר פעילות, אחרי התקנה מחדש או במכשיר חדש לגמרי. מומלץ להטמיע במשחק שחזור חלק.

1. בזמן ההפעלה, מערכת PGS מאמתת את המשתמש ומספקת למשחק את מזהה השחקן ב-PGS.
2. המשחק בודק את הבק-אנד שלו (או את טוקן הזיכרון שאוחזר אם נעשה שימוש ב-Recall API) כדי לראות אם חשבון IGA ששיחקתם בו לאחרונה כבר מקושר למזהה PGS הזה.
3. אם נמצא קישור, המשחק משחזר אוטומטית את ההתקדמות של השחקן ומבצע התחברות, בלי להציג את מסך ההתחברות הידנית.
4. אחרת, המשחק מציג לשחקן את מסך הכניסה שלו
   1. השחקן בוחר שיטת כניסה ונכנס לחשבון IGA
   2. לאחר מכן המשחק מקשר את מזהה ה-IGA הזה למזהה השחקן ב-PGS בתור מזהה ה-IGA האחרון שהופעל, כדי לאפשר שחזור חלק.

מצב אורח

השחקנים יכולים להפעיל את המשחק ולשחק בו באמצעות חשבון אורח מקומי. שירותי Play Games עדיין מאמתים את השחקן ברקע. אם השחקן בוחר באפשרות שמירת ההתקדמות, המשחק ממיר את סשן האורח למזהה גיימר קבוע ומקשר אותו למזהה השחקן. מידע נוסף על פתרון בעיות שקשורות לחשבונות בעלי מאפיינים זהים לחשבונות פעילים זמין במאמר חשבון אורח.