REST Resource: players

منبع: پلیر

یک منبع Player

نمایندگی JSON 
{
  "kind": string,
  "playerId": string,
  "displayName": string,
  "avatarImageUrl": string,
  "bannerUrlPortrait": string,
  "bannerUrlLandscape": string,
  "originalPlayerId": string,
  "profileSettings": {
    object (ProfileSettings)
  },
  "name": {
    "familyName": string,
    "givenName": string
  },
  "experienceInfo": {
    object (PlayerExperienceInfo)
  },
  "title": string,
  "friendStatus": enum (FriendStatus),
  "gamePlayerId": string
}
فیلدها
kind

string

منحصر به فرد نوع این منبع را شناسایی می کند. ارزش همیشه games#player رشته ثابت است

playerId

string

شناسه بازیکن

displayName

string

نامی که برای پخش کننده نمایش داده می شود.

avatarImageUrl

string

URL پایه تصویری که پخش کننده را نشان می دهد.

bannerUrlPortrait

string

نشانی اینترنتی تصویر بنر پخش کننده حالت عمودی.

bannerUrlLandscape

string

نشانی اینترنتی تصویر بنر پخش کننده حالت افقی.

originalPlayerId

string

شناسه بازیکنی که برای اولین باری که این بازیکن به بازی مورد نظر وارد شد، استفاده شد. این فقط برای تماس‌هایی با player.get برای پخش‌کننده درخواست‌کننده، فقط در صورتی که شناسه بازیکن متعاقباً تغییر کرده باشد، و فقط برای مشتریانی که از نقشه‌برداری مجدد شناسه‌های بازیکن پشتیبانی می‌کنند، پر می‌شود.

profileSettings

object ( ProfileSettings )

تنظیمات پروفایل بازیکن کنترل می کند که آیا نمایه بازیکن برای سایر بازیکنان قابل مشاهده است یا نه.

name

object

نمایش شیء از اجزای فردی نام بازیکن. برای برخی از بازیکنان، این زمین ها ممکن است وجود نداشته باشند.

name.familyName

string

نام خانوادگی این بازیکن در بعضی جاها به این نام خانوادگی معروف است.

name.givenName

string

نام این بازیکن در بعضی جاها به این اسم معروف است.

experienceInfo

object ( PlayerExperienceInfo )

شیئی برای نمایش اطلاعات تجربه بازی Play برای بازیکن.

title

string

عنوان بازیکن برای فعالیت های بازی آنها پاداش داده می شود.

friendStatus

enum ( FriendStatus )

وضعیت دوستی بازیکن داده شده، نسبت به درخواست کننده. اگر بازیکن لیست دوستان خود را با بازی به اشتراک نگذارد، تنظیم نشده است.

gamePlayerId

string

شناسه بازیکن منحصر به فرد برای هر برنامه.

تنظیمات پروفایل

تنظیمات پروفایل

نمایندگی JSON 
{
  "kind": string,
  "profileVisible": boolean,
  "friendsListVisibility": enum (FriendsListVisibility)
}
فیلدها
kind

string

منحصر به فرد نوع این منبع را شناسایی می کند. ارزش همیشه games#profileSettings است.

profileVisible

boolean

اینکه آیا نمایه بازیکن برای بازیکنی که در حال حاضر وارد سیستم شده است قابل مشاهده است یا خیر.

friendsListVisibility

enum ( FriendsListVisibility )

FriendsListVisibility

آیا لیست دوستان بازیکن برای این بازی قابل مشاهده است یا می توان درخواست کرد. این فیلد فقط برای بازیکنی که در حال حاضر به سیستم وارد شده است پر شده است.

Enums
VISIBLE لیست دوستان در حال حاضر برای بازی قابل مشاهده است.
REQUEST_REQUIRED برنامه‌نویس به لیست دوستان دسترسی ندارد، اما می‌تواند با Android API تماس بگیرد تا گفتگوی رضایت را نشان دهد.
UNAVAILABLE لیست دوستان در حال حاضر برای این کاربر در دسترس نیست و در حال حاضر امکان درخواست دسترسی وجود ندارد، زیرا کاربر برای همیشه رد کرده است یا ویژگی دوستان در دسترس او نیست. در این حالت، هرگونه تلاش برای درخواست دسترسی به لیست دوستان ناموفق خواهد بود.

PlayerExperienceInfo

فراداده 1P/3P درباره تجربه بازیکن.

نمایندگی JSON 
{
  "kind": string,
  "currentExperiencePoints": string,
  "lastLevelUpTimestampMillis": string,
  "currentLevel": {
    object (PlayerLevel)
  },
  "nextLevel": {
    object (PlayerLevel)
  }
}
فیلدها
kind

string

منحصر به فرد نوع این منبع را شناسایی می کند. ارزش همیشه games#playerExperienceInfo .

currentExperiencePoints

string ( int64 format)

تعداد فعلی امتیازات تجربه برای بازیکن.

lastLevelUpTimestampMillis

string ( int64 format)

مُهر زمانی زمانی که بازیکن در سطح بالاتری قرار گرفت، برحسب میلی‌لی از زمان Unix Epoch UTC.

currentLevel

object ( PlayerLevel )

سطح فعلی بازیکن

nextLevel

object ( PlayerLevel )

سطح بعدی بازیکن. اگر سطح فعلی حداکثر سطح باشد، باید همان سطح فعلی باشد.

PlayerLevel

فراداده 1P/3P در مورد سطح کاربر.

نمایندگی JSON 
{
  "kind": string,
  "level": integer,
  "minExperiencePoints": string,
  "maxExperiencePoints": string
}
فیلدها
kind

string

منحصر به فرد نوع این منبع را شناسایی می کند. ارزش همیشه games#playerLevel است.

level

integer

سطح برای کاربر.

minExperiencePoints

string ( int64 format)

حداقل امتیاز تجربه برای این سطح.

maxExperiencePoints

string ( int64 format)

حداکثر امتیاز تجربه برای این سطح.

FriendStatus

روابط دوستی بین بازیکنان را تعریف می کند.

Enums
NO_RELATIONSHIP هیچ رابطه ای بین بازیکنان وجود ندارد.
FRIEND بازیکن و درخواست کننده با هم دوست هستند.

روش ها

get

 منبع Player را با شناسه داده شده بازیابی می کند.

getMultipleApplicationPlayerIds

 شناسه پخش کننده برنامه را برای پخش کننده تأیید شده فعلی در همه بازی های درخواستی توسط همان برنامه نویسی که برنامه تماس برقرار می کند، دریافت کنید.

getScopedPlayerIds

 شناسه‌های پخش‌شده با محدوده را برای کاربر تأیید شده فعلی بازیابی می‌کند.

list

 مجموعه ای از بازیکنان را برای کاربر تأیید شده فعلی دریافت کنید.