כניסה

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

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

  • להמשיך מהנקודה שבה הפסיקו אם הם מחליפים או מאפסים את המכשיר
  • לשחק במשחק במספר מכשירים (למשל, בטלפון אחר או ב-Chromebook)
  • הסרת המשחק והתקנתו מחדש מאוחר יותר

אתם יכולים להשתמש בזהות של Play Games Services כמפתח לפתרון השמירה שלכם בענן, או להשתמש בשירות המשחקים השמורים בחינם.

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

תהליך הכניסה המומלץ

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

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

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

כניסה אוטומטית

כניסה אוטומטית מאפשרת למשתמשים להיכנס למשחק ללא טרחה – היא אוטומטית! אם המשחק שלכם מבקש מהמשתמש להיכנס וההגדרה של הכניסה האוטומטית מופעלת (באפליקציית Google Play Games), תקבלו את פרטי הכניסה של המשתמש ב-PGS והמשתמש יראה את חוויית הכניסה ל-PGS.

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

כניסה אוטומטית

כניסה ידנית לחשבון

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

כניסה ידנית לחשבון

אישור חלונות קופצים מסוג PGS כדי ליהנות מחוויית כניסה תקינה

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

כדי להציג את חוויית הכניסה לחשבון, צריך להפעיל את השיטה setViewForPopups() של הכיתה GamesClient בזמן הפעלת המשחק. זה חיוני כדי לספק את חוויית המשתמש הנכונה.

היקפי הרשאות OAuth ו-PGS

PGS מסתמך על מערכת OAuth כדי לאפשר למשתמשים לתת למשחק גישה לחשבון שלהם. היקפי הרשאות OAuth הם הרשאות שאתם, בתור מפתחים, יכולים לבקש. אם ההרשאות האלה יאושרו, המשחק יוכל להפעיל ממשקי API מסוימים מטעם המשתמש, וגם תהיה לכם גישה לחלקים מסוימים בחשבון Google שלו.

ל-PGS יש היקף ייחודי למשחקים (games-lite), והוא מסתמך על היקף אחר (drive.appdata) אם המשחק משתמש בתכונה 'משחקים שמורים'. התכונה 'משחקים שמורים' מעניקה גישה לחשבון Google Drive של המשתמש, שבו מאוחסנים נתוני המשחק.

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

השיטה המומלצת היא להשתמש בבקשות עם היקף מצטבר. במשחק צריך לבקש היקפי גישה של PGS בלבד בבקשה הראשונית, ולבקש היקפי גישה אחרים בנפרד ברגע רלוונטי יותר.

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

תמיכה במספר שיטות כניסה

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

אחזור מאובטח של זהות הנגן ואימות שלה לשילוב בקצה העורפי

אתם יכולים לבקש קוד אימות לשרת כדי לאפשר לשרת שלכם לתקשר ישירות עם שרתי שירותי המשחקים של Play דרך ה-API ל-REST, באמצעות ההרשאה של השחקן שמחובר לחשבון. כך אפשר לגשת ישירות למזהה, לפרופיל ולמידע נוסף של השחקן (למשל רשימת החברים, אם יש הרשאה). אם אתם מאחסנים מזהי שחקנים, מזהי חברים או נתונים קשורים אחרים בקצה העורפי, עליכם להשתמש בשיטה הזו כדי למנוע אפשרות של מניפולציה בשדות האלה בצד המכשיר.

בנוסף, בחלק מהמשחקים והשחקנים הישנים, מזהה השחקן שמוחזר על ידי ה-SDK של Android עשוי להיות שונה מהמזהה ששחקנים אחרים רואים כשהם צופים באותו שחקן באותו משחק. הדבר רלוונטי במיוחד כשמשתמשים ברשימת החברים. עם זאת, הערך של player_id שמוחזר ב-API ל-REST תמיד עקבי ותמיד זה המזהה שמוצג לשחקנים אחרים.

מידע נוסף זמין במאמר גישה אופליין ובמסמכי העזרה של API ל-REST.

הטמעה בצד הלקוח

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