בעקבות הוצאה משימוש של Google Sign-In API, אנחנו מסירים את ה-SDK בגרסה Games v1 בשנת 2026. אחרי פברואר 2025, לא תהיה לך אפשרות לפרסם ב-Google Play משחקים ששולבו לאחרונה עם ה-SDK בגרסה Games v1. מומלץ להשתמש ב-SDK בגרסה Games v2.
פריטים קיימים עם שילובים קודמים של משחקים בגרסה 1 ימשיכו לפעול למשך כמה שנים, אבל מומלץ לעבור לגרסה 2 החל מיוני 2025.
המדריך הזה מיועד לשימוש ב-SDK של Play Games Services בגרסה 1. מידע על גרסת ה-SDK העדכנית זמין במאמרי העזרה בנושא גרסה 2.
הכניסה באמצעות Play Games Services מספקת לכם את זהות הגיימינג של השחקן, שהיא זהות ספציפית לגיימינג ברמת הפלטפורמה לשחקנים ב-Android. הזהות הזו עוזרת ליצור קשר בין המשחק לבין השחקן. השחקנים מוכנים יותר להשתמש בזהות הזו כדי להיכנס לחשבון מאשר במערכות מרכזיות חלופיות.
בנוסף, הכניסה לחשבון מספקת לכם מזהה חזק ועקבי שבו תוכלו להשתמש כמפתח למערכת שמירת נתונים בענן. שמירה בענן היא תכונה חשובה מאוד, והיא מאפשרת לשחקנים:
- אפשרות להמשיך מהנקודה שבה הפסקתם אם הם מחליפים או מאפסים את המכשיר
- להפעיל את המשחק בכמה מכשירים (לדוגמה, בטלפון אחר או ב-Chromebook)
- הסרת המשחק והתקנה מחדש מאוחר יותר
אתם יכולים להשתמש בזהות של Play Games Services כמפתח לפתרון משלכם לשמירת נתונים בענן, או להשתמש בשירות Saved Games בחינם.
שירותי Play Games (PGS) תומכים בכניסה אוטומטית, שהיא דרך חלקה לכניסת שחקנים, וגם בכניסה ידנית, שהיא תהליך של קליק אחד. במאמר הזה מתוארות השיטות השונות האלה לכניסה לחשבון.
תהליך הכניסה המומלץ
כדי שהשחקנים יוכלו להיכנס למשחק שלכם, אתם צריכים להשתמש בתהליך הכניסה הבא:
- במהלך רצף ההפעלה של המשחק, מנסים להשתמש בכניסה אוטומטית כדי שהשחקן ייכנס אוטומטית.
- אם הכניסה האוטומטית לא פועלת והמכשיר של המשתמש מחובר לאינטרנט, אפשר לנסות כניסה ידנית.
- אם המשתמש דוחה את הכניסה הידנית, צריך לזכור את הבחירה שלו ולא להציג שוב כניסה ידנית, אבל להמשיך לנסות כניסה אוטומטית בהפעלה.
בנוסף, חשוב לוודא שהמשתמשים יכולים להיכנס למשחק באמצעות חשבון Play Games Services שלהם בלחיצה על לחצן ייעודי שקל למצוא.
כניסה אוטומטית
כניסה אוטומטית מאפשרת למשתמשים להיכנס למשחק שלכם בלי שום טרחה – היא אוטומטית! אם המשחק שלכם מבקש מהמשתמש להיכנס לחשבון וההגדרה של כניסה אוטומטית מופעלת (באפליקציית Google Play Games), תקבלו את פרטי הכניסה של המשתמש ל-PGS והמשתמש יראה את חוויית הכניסה ל-PGS.
הכניסה האוטומטית היא הגדרה שהמשתמשים יכולים לשלוט בה. המשתמשים יכולים לבחור אם להיכנס אוטומטית לכל המשחקים או לקבל בקשה בכל פעם.
כניסה ידנית לחשבון
אם משתמש לא נכנס למשחק באופן אוטומטי, אפשר לבקש ממנו להיכנס באופן ידני. המשתמשים יכולים להיכנס בלחיצה אחת מתיבת דו-שיח שמוצגת מעל המשחק.
אישור חלונות קופצים של PGS כדי לאפשר כניסה תקינה
כשמשתמשים ב-PGS, הם צריכים לדעת שהם מחוברים לחשבון. כדי לעשות זאת, מוצגת חוויית הכניסה ל-PGS.
כדי להציג את חוויית הכניסה לחשבון, קוראים ל-method 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.
אחזור מאובטח של זהות השחקן ואימות שלה לצורך שילוב עם ה-Backend
אתם יכולים לבקש קוד הרשאה לשרת כדי לאפשר לשרת שלכם לתקשר ישירות עם השרתים של Play Games Services באמצעות REST API, עם ההרשאה של השחקן המחובר. ההרשאה הזו מאפשרת גישה ישירה למזהה של השחקן, לפרופיל ולמידע אחר (כמו רשימת החברים, אם יש הרשאה). אם אתם מאחסנים בשרת העורפי מזהי שחקנים, מזהי חברים או נתונים קשורים אחרים, אתם צריכים להשתמש בשיטה הזו כדי למנוע אפשרות של שינוי השדות האלה בצד המכשיר.
בנוסף, במשחקים ישנים מסוימים ולשחקנים מסוימים, יכול להיות שמזהה השחקן שמוחזר על ידי ה-SDK של Android עבור שחקן מסוים לא יהיה זהה למזהה ששחקנים אחרים רואים כשהם צופים בשחקן הזה באותו משחק – זה רלוונטי במיוחד כשמשתמשים ברשימת החברים. עם זאת, הערך player_id שמוחזר ב-REST API תמיד עקבי ותמיד זהה למזהה ששחקנים אחרים רואים.
מידע נוסף מופיע במאמרים בנושא גישה אופליין ובמסמכי העזרה בנושא REST API.
הטמעה בצד הלקוח
כדי ללמוד איך להטמיע תמיכה בכניסה ב-Android, אפשר לעיין במאמר בנושא כניסה למשחקי Android.