משאב: נגן
משאב נגן.
ייצוג JSON |
---|
{ "kind": string, "playerId": string, "displayName": string, "avatarImageUrl": string, "bannerUrlPortrait": string, "bannerUrlLandscape": string, "originalPlayerId": string, "profileSettings": { object ( |
שדות | |
---|---|
kind |
מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה |
playerId |
מזהה השחקן. |
displayName |
השם שיוצג עבור הנגן. |
avatarImageUrl |
כתובת ה-URL הבסיסית של התמונה שמייצגת את הנגן. |
bannerUrlPortrait |
כתובת ה-URL לתמונת הבאנר של הנגן בפריסה לאורך. |
bannerUrlLandscape |
כתובת ה-URL לתמונת הבאנר של הנגן בפריסה לרוחב. |
originalPlayerId |
מזהה השחקן ששימש לשחקן הזה בפעם הראשונה שהוא נכנס למשחק הרלוונטי. השדה הזה מאוכלס רק עבור קריאות ל-נגן.get עבור הנגן ששלח את הבקשה, רק אם מזהה הנגן השתנה לאחר מכן, ורק ללקוחות שתומכים במיפוי מחדש של מזהי נגנים. |
profileSettings |
הגדרות הפרופיל של השחקן. המדיניות קובעת אם פרופיל השחקן גלוי לשחקנים אחרים. |
name |
ייצוג אובייקט של הרכיבים הבודדים בשם השחקן. יכול להיות שהשדות האלה לא יהיו זמינים בחלק מהנגנים. |
name.familyName |
שם המשפחה של השחקן הזה. במקומות מסוימים, הוא נקרא שם המשפחה. |
name.givenName |
השם הפרטי של השחקן הזה. במקומות מסוימים, זה נקרא השם הפרטי. |
experienceInfo |
אובייקט שמייצג את המידע על חוויית המשחק ב-Play Games של הנגן. |
title |
השם של השחקן מתגמל על הפעילויות שלו במשחק. |
friendStatus |
סטטוס החברות של השחקן הנתון, ביחס למגיש הבקשה. ההגדרה הזו לא מוגדרת אם השחקן לא משתף את רשימת החברים שלו עם המשחק. |
gamePlayerId |
מזהה נגן ייחודי לכל אפליקציה. |
ProfileSettings
הגדרות הפרופיל
ייצוג JSON |
---|
{
"kind": string,
"profileVisible": boolean,
"friendsListVisibility": enum ( |
שדות | |
---|---|
kind |
מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה |
profileVisible |
האם הפרופיל של השחקן גלוי לשחקן שמחובר כרגע. |
friendsListVisibility |
|
FriendsListVisibility
אם רשימת החברים של השחקן גלויה למשחק הזה, או שאפשר לבקש אותו. השדה הזה מאוכלס רק עבור הנגן שמחובר כרגע.
טיפוסים בני מנייה (enum) | |
---|---|
VISIBLE |
רשימת החברים גלויה כרגע למשחק. |
REQUEST_REQUIRED |
למפתח אין גישה לרשימת החברים, אבל הוא יכול להפעיל את Android API כדי להציג תיבת דו-שיח להבעת הסכמה. |
UNAVAILABLE |
רשימת החברים לא זמינה כרגע למשתמש הזה, ואין אפשרות לבקש גישה בשלב הזה בגלל שהמשתמש דחה את הבקשה באופן קבוע או שתכונת החברים לא זמינה לו. במצב הזה, כל ניסיון לבקש גישה לרשימת החברים ייכשל. |
PlayerExperienceInfo
מטא-נתונים של אינטראקציה ישירה או מצד שלישי על חוויית השחקן.
ייצוג JSON |
---|
{ "kind": string, "currentExperiencePoints": string, "lastLevelUpTimestampMillis": string, "currentLevel": { object ( |
שדות | |
---|---|
kind |
מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה |
currentExperiencePoints |
המספר הנוכחי של נקודות הניסיון של השחקן. |
lastLevelUpTimestampMillis |
חותמת הזמן שבה השחקן התקדם לשלב הבא, באלפיות השנייה מאז תאריך יוניקס (Unix epoch) לפי שעון UTC. |
currentLevel |
הרמה הנוכחית של הנגן. |
nextLevel |
הרמה הבאה של הנגן. אם הרמה הנוכחית היא הרמה המקסימלית, היא צריכה להיות זהה לרמה הנוכחית. |
PlayerLevel
מטא-נתונים של צד שלישי לגבי רמת המשתמש.
ייצוג JSON |
---|
{ "kind": string, "level": integer, "minExperiencePoints": string, "maxExperiencePoints": string } |
שדות | |
---|---|
kind |
מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה |
level |
הרמה שבה נמצא המשתמש. |
minExperiencePoints |
נקודות הניסיון המינימליות לרמה הזו. |
maxExperiencePoints |
מספר נקודות הניסיון המקסימלי לרמה הזו. |
FriendStatus
הגדרה של יחסי חברות בין השחקנים.
טיפוסים בני מנייה (enum) | |
---|---|
NO_RELATIONSHIP |
אין קשר בין השחקנים. |
FRIEND |
השחקן ומגיש הבקשה הם חברים. |
שיטות |
|
---|---|
|
מאחזר את משאב Player עם המזהה הנתון. |
|
קבלת מזהי הנגן של האפליקציות של השחקן המאומת בכל המשחקים המבוקשים על ידי אותו מפתח כמו אפליקציית הקריאה. |
|
אחזור של מזהי נגנים בהיקף של משתמשים מאומתים נוכחיים. |
|
קבלת אוסף הנגנים של המשתמש המאומת. |