חברים

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

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

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

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

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

ייבוא חברים

מה צריך לעשות

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

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

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

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

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

השלבים הבאים

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