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