חברים

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

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

  • ניתן להשוות תוצאות עם החברים שלהם בטבלאות הישגים.

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

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

ייבוא חברים

היסודות

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

חברים בלידרבורד

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

השלבים הבאים

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