חברים

משתמשים בממשקי ה-API של Friends כדי להשלים ולשפר את מערכת החברים הקיימת במשחק ובמערכות חברתיות אחרות שיש למשחק גישה אליהן. כך תוכלו לאפשר לשחקנים:

  • מוצאים את החברים שלהם במשחק.

  • משווים ניקוד עם חברים בלוח הישגי השחקנים המובילים.

  • אפשר לשלב את רשימת החברים שלהם ב-Play Games עם רשימות קיימות בתוך המשחק של חברים.

  • מזהים שחקן נוסף באמצעות חלון קופץ של פרופיל בתוך המשחק. בחלון הקופץ הזה מוצגת הכינוי שהשחקן הנוכחי נתן לחבר שלו, כדי שהוא ידע מי שהם משחקים איתם.

ייבוא חברים

היסודות

ממשקי ה-API האלה מאפשרים לבצע את הפעולות הבאות:

  • טעינת חברים: אפשר לבדוק אם השחקן אישר למשחק לגשת מידע על רשימת החברים. אם ניתנה גישה, תהיה לך אפשרות לקבל רשימה של הנגן אובייקטים שתואמים לחברים של השחקן המחובר.
  • הפעלת תצוגת פרופיל של שחקן אחר ב-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()), זה יטופל בשבילך באופן אוטומטי.

השלבים הבאים

לפני שמתחילים להשתמש בממשקי Friends API, צריך לבצע את הפעולות הבאות: