Esta página foi traduzida pela API Cloud Translation.

Players

Um jogador representa um jogador humano em placares e conquistas.

Para ver uma lista de métodos desse recurso, consulte o final desta página.

Representações de recursos

Este é um modelo JSON para um recurso Player.

{
  "kind": "games#player",
  "playerId": string,
  "displayName": string,
  "avatarImageUrl": string,
  "bannerUrlPortrait": string,
  "bannerUrlLandscape": string,
  "originalPlayerId": string,
  "lastPlayedWith": {
    "kind": "games#played",
    "timeMillis": long,
    "autoMatched": boolean
  },
  "profileSettings": {
    "kind": "games#profileSettings",
    "profileVisible": boolean,
    "friendsListVisibility": string
  },
  "name": {
    "familyName": string,
    "givenName": string
  },
  "experienceInfo": {
    "kind": "games#playerExperienceInfo",
    "currentExperiencePoints": long,
    "lastLevelUpTimestampMillis": long,
    "currentLevel": {
      "kind": "games#playerLevel",
      "level": integer,
      "minExperiencePoints": long,
      "maxExperiencePoints": long
    },
    "nextLevel": {
      "kind": "games#playerLevel",
      "level": integer,
      "minExperiencePoints": long,
      "maxExperiencePoints": long
    }
  },
  "title": string,
  "friendStatus": string
}

Nome da propriedade	Valor	Descrição
`avatarImageUrl`	`string`	URL de base da imagem que representa o player.
`bannerUrlLandscape`	`string`	O URL para a imagem do banner do player no modo paisagem.
`bannerUrlPortrait`	`string`	O URL para a imagem do banner do player no modo retrato.
`displayName`	`string`	Nome a ser exibido para o player.
`experienceInfo`	`nested object`	Um objeto para representar informações da experiência do Play Games para o jogador.
`experienceInfo.currentExperiencePoints`	`long`	É o número atual de pontos de experiência do jogador.
`experienceInfo.currentLevel`	`nested object`	O nível atual do player.
`experienceInfo.currentLevel.kind`	`string`	Identifica exclusivamente o tipo do recurso. O valor é sempre a string fixa `games#playerLevel`.
`experienceInfo.currentLevel.level`	`integer`	O nível do usuário.
`experienceInfo.currentLevel.maxExperiencePoints`	`long`	Os pontos máximos de experiência para este nível.
`experienceInfo.currentLevel.minExperiencePoints`	`long`	Os pontos mínimos de experiência para esse nível.
`experienceInfo.kind`	`string`	Identifica exclusivamente o tipo do recurso. O valor é sempre a string fixa `games#playerExperienceInfo`.
`experienceInfo.lastLevelUpTimestampMillis`	`long`	É o carimbo de data/hora em que o jogador subiu de nível, em milissegundos desde a era Unix UTC.
`experienceInfo.nextLevel`	`nested object`	O próximo nível do jogador. Se o nível atual for o nível máximo, ele deve ser igual ao nível atual.
`experienceInfo.nextLevel.kind`	`string`	Identifica exclusivamente o tipo do recurso. O valor é sempre a string fixa `games#playerLevel`.
`experienceInfo.nextLevel.level`	`integer`	O nível do usuário.
`experienceInfo.nextLevel.maxExperiencePoints`	`long`	Os pontos máximos de experiência para este nível.
`experienceInfo.nextLevel.minExperiencePoints`	`long`	Os pontos mínimos de experiência para esse nível.
`friendStatus`	`string`	É o status de amigo de um determinado jogador em relação ao solicitante. Essa opção não é definida se o jogador não estiver compartilhando a lista de amigos com o jogo. Os valores aceitáveis são: "`FRIEND`" "`NO_RELATIONSHIP`"
`kind`	`string`	Identifica exclusivamente o tipo do recurso. O valor é sempre a string fixa `games#player`.
`lastPlayedWith`	`nested object`	Detalhes sobre a última vez que este jogador jogou com vários jogadores no momento. Preenchido para membros da coleção de jogadores PLAYED_WITH.
`lastPlayedWith.autoMatched`	`boolean`	Verdadeiro se o jogador tiver feito a correspondência automática com o usuário autenticado no momento.
`lastPlayedWith.kind`	`string`	Identifica exclusivamente o tipo do recurso. O valor é sempre a string fixa `games#played`.
`lastPlayedWith.timeMillis`	`long`	A última vez que o jogador jogou em milissegundos desde o período em UTC.
`name`	`object`	Representação de objetos dos componentes individuais do nome do jogador. Esses campos podem não estar presentes em alguns jogadores.
`name.familyName`	`string`	Sobrenome do jogador. Em alguns lugares, isso é conhecido como sobrenome.
`name.givenName`	`string`	Nome do jogador. Em alguns lugares, isso é conhecido como o nome.
`originalPlayerId`	`string`	É o ID usado para o jogador na primeira vez que ele fez login no jogo em questão. Isso só é preenchido nas chamadas de player.get para o jogador solicitante, somente se o ID do jogador tiver sido alterado posteriormente e somente para clientes compatíveis com o remapeamento de IDs de jogador.
`playerId`	`string`	ID do jogador.
`profileSettings`	`nested object`	Configurações do perfil do jogador. Controla se o perfil do jogador fica visível para outros jogadores.
`profileSettings.friendsListVisibility`	`string`	Indica se a lista de amigos do jogador está visível para o jogo. Os valores aceitáveis são: "`REQUEST_REQUIRED`" "`UNAVAILABLE`" "`VISIBLE`"
`profileSettings.kind`	`string`	Identifica exclusivamente o tipo do recurso. O valor é sempre a string fixa `games#profileSettings`.
`profileSettings.profileVisible`	`boolean`
`title`	`string`	O título do jogador recompensado pelas atividades no jogo.

Métodos

get: Recupera o recurso Player com o ID fornecido. Para recuperar o jogador do usuário autenticado no momento, defina playerId como me.
list: Acesse a coleção de jogadores para o usuário autenticado no momento.