חברים

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

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

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

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

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

ייבוא חברים

יסודות

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

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

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

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

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

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

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

כשמשתמשים ברשימת החברים משרת backend, צריך לטעון אותה בצורה מאובטחת באמצעות 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 של Friends, צריך לבצע את הפעולות הבאות: