חברים

אתם יכולים להשתמש ב-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: