אתם יכולים להשתמש ב-Friends APIs כדי להשלים ולשפר את מערכת החברים הקיימת במשחק, וגם מערכות חברתיות אחרות שהמשחק עשוי לגשת אליהן. כך תוכלו לאפשר לשחקנים:
למצוא את החברים שלהם במשחק.
להשוות את הנקודות שלהם עם חברים בלוחות לידרבורד.
לשלב את רשימת החברים שלהם ב-Play Games עם רשימות קיימות של חברים במשחקים.
לזהות שחקן אחר באמצעות חלון קופץ של פרופיל בתוך המשחק. בחלון הקופץ הזה מוצג הכינוי שהשחקן הנוכחי נתן לחבר שלו, כדי שהחבר ידע עם מי הוא משחק.
יסודות
ממשקי ה-API האלה מאפשרים לבצע את הפעולות הבאות:
- טעינת חברים: אפשר לבדוק אם השחקן אישר למשחק לגשת לפרטים של רשימת החברים. אם תקבלו גישה, תוכלו לקבל רשימה של אובייקטים מסוג Player שתואמים לחברים של השחקן שמחובר לחשבון.
- הצגת פרופיל Play Games של שחקן אחר: אפשר לפתוח את התצוגה הזו כדי להציג את השם שהשחקן שנכנס לחשבון נתן לשחקן השני. בתצוגה הזו יש גם אמצעי בקרה לניהול החברויות, והשחקן לא יוציא אתכם מהמשחק.
- מתן אמצעי בקרה למשתמשים: למשתמש יש אמצעי בקרה שמאפשרים לקבוע איך הפרופיל שלו ב-Play Games גלוי לחברים ואיך רשימת החברים שלו תהיה גלויה למשחקים. לגבי הגישה לרשימת החברים, המשתמש יכול לבחור להעניק גישה באופן אוטומטי לכל המשחקים, או לאשר את הגישה בנפרד לכל משחק. כתוצאה מכך, כשטוענים את רשימת החברים, יכול להיות שתוצג בקשה חוזרת (callback).
ייבוא רשימת חברים מ-Play Games
אתם יכולים להשתמש ב-Friends API כדי לקבל רשימה של החברים של השחקנים ב-Play Games ולהוסיף אותם לרשימת החברים במשחק.
משתמשים חדשים יקבלו רשימת חברים ראשונית לשחק איתם, ומשתמשים קיימים יוכלו לייבא את החברים שלהם ב-Play Games לכל רשימת חברים במשחק. כתוצאה מכך, למשתמשים תהיה קבוצה גדולה ככל האפשר של שחקנים לשחק איתם או להתחרות מולם.
הוספת חברים למשחק ב-Play Games
תוכלו לשייך את מזהה Play Games של החברים ב-Play Games לפרטי השחקן המתאימים במסד הנתונים הפנימי שלכם, וכך להוסיף אותם לרשימת החברים הקיימת במשחק. חשוב לוודא שיש ליד החברים האלה לחצן עם הסמל של Play Games, שמציג את הפרופיל של השחקן השני כשלוחצים עליו, כדי שהמשתמשים יוכלו לדעת מי החברים.
כשמשתמשים ברשימת החברים משרת קצה עורפי, צריך לטעון אותה באופן מאובטח באמצעות API ל-REST במקום להעביר את התוצאה של Android API. חשוב להשתמש במזהה השחקן שמוחזר על ידי players.get(me)
ב-API ל-REST עבור השחקן שמחובר כרגע, כי זה יהיה זהה למזהה ששחקנים אחרים רואים.
אם רשימת החברים המשופרת לא מאוחסנת (אלא רק משמשת בזמן הצפייה), אין צורך לבצע פעולה נוספת.
הענקת גישה ל-Play Games
אם למשחק שלכם עדיין אין גישה ל-Play Games, מומלץ לבקש מהמשתמשים את הסכמתם כשהם צופים ברשימת החברים במשחק. לדוגמה, אפשר להוסיף לחצן בשם ייבוא חברים מ-Play Games, שיציג למשתמש בקשה להביע הסכמה כשהוא מקייש עליו. (חשוב להשתמש בלוגו של Play Games בכל לחצן שבו מוזכר השירות).
הצגת הפרופיל של שחקן אחר
אתם יכולים לאפשר לשחקן שמחובר לחשבון לראות את פרופיל Play Games של שחקן אחר. כך השחקן שמחובר לחשבון יכול לראות את השם שהקצה לשחקן השני ואם הם כבר חברים, וכך לקבל הקשר נוסף לגבי הקשר ביניהם. אם השחקנים עדיין לא חברים, השחקן שמחובר לחשבון יוכל לראות את אמצעי הבקרה לניהול החברות בתצוגת הפרופיל. כשיוצרים חברויות מתוך המשחק, שמות ברירת המחדל של שני השחקנים הם השמות שלהם במשחק (אם הם סיפקו אותם). שם המשחק שבו התחיל הקשר גם מוצג.
לוחות לידרבורד של רשתות חברתיות
ניתן להשתמש בממשקי ה-API של Friends גם ללוחות הישגי השחקנים המובילים. אפשר להשתמש בתכונה הזו כדי להציג את הדירוג של השחקן הנוכחי מבין חבריו ב-Play Games. חשוב לזכור שהתכונה הזו רלוונטית רק למשתמשים שבחרתם לשתף איתם את המידע הזה באפליקציה, ורק אם המשתמשים האלה הם חברים ב-Play Games. כדי לתמוך בתכונה הזו, המשחק חושף אמצעי בקרה למשתמשים. אמצעי הבקרה הזה משתמש בארגומנט collection
כדי לבחור את התצוגה החברתית של הלידרבורד. מידע נוסף זמין בקטע לוחות מודעות ציבוריים וחברתיים.
אם מטמיעים את האוסף של לידרבורדים של רשתות חברתיות, הקריאה לטעינה של הציונים בלידרבורד עשויה להחזיר חריגה של פתרון שדורשת הסכמה, בדומה לזו של loadFriends()
.
אם מטמיעים את ממשק המשתמש שמסופק כברירת מחדל על ידי Play Games (לדוגמה, getLeaderboardIntent()
), המערכת מטפלת בזה באופן אוטומטי.
השלבים הבאים
לפני שמתחילים להשתמש בממשקי ה-API של Friends:
- מורידים קוד לדוגמה ובודקים אותו:
- כדאי לעיין בהמלצות שמפורטות ברשימת המשימות לבדיקת איכות.
- הטמעת Friends APIs בלקוח Java.