חברים

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

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

  • להשוות את הניקוד עם חברים בלוחות לידרבורד.

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

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

ייבוא חברים

יסודות

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

  • טעינת חברים: אפשר לבדוק אם השחקן הרשה למשחק לגשת לפרטי רשימת החברים. אם הגישה ניתנת, אפשר לקבל רשימה של אובייקטים מסוג Player שמתאימים לחברים של השחקן המאומת.
  • הצגת פרופיל של שחקן אחר ב-Play Games: אתם יכולים לפתוח את התצוגה הזו כדי להציג את השם שניתן לשחקן האחר על ידי השחקן המאומת. בנוסף, בתצוגה הזו יש אמצעי בקרה לניהול חברויות, והיא לא מוציאה את השחקן מהמשחק.
  • אמצעי בקרה למשתמשים: המשתמשים יכולים לקבוע מי יכול לראות את הפרופיל שלהם ב-Play Games ומי יכול לראות את רשימת החברים שלהם במשחקים. בנוגע לגישה לרשימת החברים, המשתמש יכול לבחור להעניק גישה אוטומטית לכל המשחקים או לאשר גישה לכל משחק בנפרד. לכן, כשמטעינים את רשימת החברים, יכול להיות שתתקבל קריאה חוזרת להצגת בקשת גישה.

ייבוא רשימת חברים מ-Play Games

אתם יכולים להשתמש ב-Friends APIs כדי לקבל רשימה של החברים של השחקנים שלכם ב-Play Games ולהוסיף אותם לרשימת החברים במשחק.

למשתמשים חדשים תהיה רשימה ראשונית של חברים שאיתם הם יכולים לשחק, ומשתמשים קיימים יכולים לייבא את החברים שלהם ב-Play Games לכל רשימת חברים במשחק. כתוצאה מכך, למשתמשים שלכם יהיה את המגוון הכי גדול של שחקנים שאיתם הם יכולים לשחק או להתחרות.

הוספת חברים ב-Play Games למשחק

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

כשמשתמשים ברשימת החברים משרת קצה עורפי, צריך לטעון אותה בצורה מאובטחת באמצעות API ל-REST, ולא להעביר את התוצאה של Android API. חשוב להשתמש במזהה השחקן שמוחזר על ידי players.get(me) ב-REST API עבור השחקן המאומת הנוכחי, כי הוא יהיה זהה למזהה ששחקנים אחרים רואים.

אם רשימת החברים המשופרת לא מאוחסנת (אלא רק נמצאת בשימוש בזמן הצפייה), לא נדרשת עבודה נוספת.

הענקת גישה ל-Play Games

אם למשחק שלכם עדיין אין גישה ל-Play Games, כדאי לבקש מהמשתמשים את ההסכמה שלהם כשהם צופים ברשימת החברים במשחק. לדוגמה, אפשר להוסיף לחצן בשם ייבוא חברים מ-Play Games, שכשמקישים עליו מוצגת למשתמש בקשה להבעת הסכמה. (חשוב להשתמש בלוגו של Play Games בכל לחצן שמוזכר בו השירות).

הצגת הפרופיל של שחקן אחר

אתם יכולים לאפשר לשחקן המאומת שלכם לראות את הפרופיל של שחקן אחר ב-Play Games. כך השחקן המאומת יכול לראות את השם שניתן לשחקן השני ואם הם כבר חברים, ולקבל הקשר נוסף לגבי הקשר ביניהם. אם השחקנים עדיין לא חברים, השחקן המאומת יראה את אמצעי הבקרה לניהול החברות בתצוגת הפרופיל. כשיוצרים חברויות מתוך המשחק, שמות ברירת המחדל של שני השחקנים הם השמות שלהם במשחק (אם הם צוינו). מוצג גם שם המשחק שבו נוצר הקשר.

הצגת הפרופיל של שחקן אחר

לוחות לידרבורד של רשתות חברתיות

אפשר להשתמש בממשקי ה-API של החברים גם לטבלאות הישגים. אפשר להשתמש בתכונה הזו כדי להציג את הדירוג של השחקן הנוכחי בקרב החברים שלו ב-Play Games. שימו לב שהדבר רלוונטי רק למשתמשים שבחרו לשתף את המידע הזה עם האפליקציה שלכם, ורק אם המשתמשים הם חברים ב-Play Games. כדי לתמוך בתכונה הזו, המשחק חושף אמצעי בקרה למשתמש. הפקד הזה משתמש בארגומנט collection כדי לבחור את התצוגה החברתית של טבלת הבאז. מידע נוסף זמין בקטע בנושא טבלאות הישגים ציבוריות וחברתיות.

אם מטמיעים את האוסף של טבלאות הדירוג החברתיות, יכול להיות שהקריאה לטעינת הניקוד בטבלת הדירוג תחזיר חריגה של רזולוציה שנדרשת בה הסכמה, בדומה לזו שמופיעה ב-loadFriends(). אם מטמיעים את ממשק המשתמש שמוגדר כברירת מחדל ב-Play Games (לדוגמה, getLeaderboardIntent()), המערכת מטפלת בזה באופן אוטומטי.

השלבים הבאים

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