כניסה

הכניסה ל-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

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

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

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

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

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

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

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

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

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

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

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

הטמעת לקוח

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