כניסה

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

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

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

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

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

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

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

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

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

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

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

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

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

כניסה ידנית

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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