gpg::Player

#include <player.h>

Uma estrutura de dados que permite acessar dados sobre um jogador específico.

Resumo

Construtores e destrutores

Player()
Player(std::shared_ptr< const PlayerImpl > impl)
Cria um Player de um shared_ptr para um PlayerImpl.
Player(const Player & copy_from)
Cria uma cópia de um jogador.
Player(Player && move_from)
Move um jogador para um novo.
~Player()

Funções públicas

AvatarUrl(ImageResolution resolution) const
const std::string &
Retorna o URL em que a imagem do avatar do jogador está armazenada.
CurrentLevel() const
const PlayerLevel &
Recupera os dados do nível atual do jogador, se conhecidos.
CurrentXP() const
uint64_t
Recupera o total de XP atual do jogador.
HasLevelInfo() const
bool
Retorna se o jogador tem ou não informações de nível disponíveis.
Id() const
const std::string &
Retorna o Id do jogador conectado no momento.
LastLevelUpTime() const
Recupera o carimbo de data/hora em que o jogador passou de nível pela última vez.
Name() const
const std::string &
Retorna o nome do Google+ do jogador conectado no momento.
NextLevel() const
const PlayerLevel &
Recupera os dados do próximo nível do jogador, se conhecidos.
Title() const
const std::string &
Recupera o título do player.
Valid() const
bool
Retorna "true" quando o player retornado é preenchido com dados e acompanhado por um status de resposta bem-sucedido. Retorna "false" para um player criado pelo usuário sem preenchimento ou para um preenchido acompanhado por um status de resposta com falha.
operator=(const Player & copy_from)
Player &
Atribui esse jogador copiando de outro.
operator=(Player && move_from)
Player &
Atribui esse valor de Player movendo outro para ele.

Funções públicas

AvatarUrl

const std::string & AvatarUrl(
  ImageResolution resolution
) const 

Retorna o URL em que a imagem do avatar do jogador está armazenada.

O parâmetro ImageResolution especifica a resolução da imagem. Player::Valid() precisa retornar "true" para que essa função seja utilizável.

CurrentLevel

const PlayerLevel & CurrentLevel() const 

Recupera os dados do nível atual do jogador, se conhecidos.

Se HasLevelInfo() retornar falso, isso vai retornar um objeto PlayerLevel para o qual Valid() também retornará falso.

CurrentXP

uint64_t CurrentXP() const 

Recupera o total de XP atual do jogador.

Se HasLevelInfo() retornar falso, o valor será zero. Se HasLevelInfo() retornar "true", o total de XP atual do jogador vai estar no intervalo CurrentLevel().MinimumXP a CurrentLevel().MaximumXP.

HasLevelInfo

bool HasLevelInfo() const 

Retorna se o jogador tem ou não informações de nível disponíveis.

Se ele retornar falso, CurrentLevel() e NextLevel() vão retornar objetos PlayerLevel que não são válidos.

ID

const std::string & Id() const 

Retorna o Id do jogador conectado no momento.

Player::Valid() precisa retornar "true" para que essa função seja utilizável.

LastLevelUpTime

Timestamp LastLevelUpTime() const 

Recupera o carimbo de data/hora em que o jogador passou de nível pela última vez.

Se HasLevelInfo() retornar falso ou se o jogador nunca tiver subido de nível, o valor será zero (a época).

Nome

const std::string & Name() const 

Retorna o nome do Google+ do jogador conectado no momento.

Player::Valid() precisa retornar "true" para que essa função seja utilizável.

NextLevel

const PlayerLevel & NextLevel() const 

Recupera os dados do próximo nível do jogador, se conhecidos.

Se HasLevelInfo() retornar falso, isso vai retornar um objeto PlayerLevel para o qual Valid() também retornará falso. Esse é o nível que o jogador está tentando alcançar. Se o jogador já estiver no nível máximo que pode alcançar, CurrentLevel() e NextLevel() vão retornar valores idênticos.

Jogador

 Player()

Jogador

 Player(
  std::shared_ptr< const PlayerImpl > impl
)

Cria um Player de um shared_ptr para um PlayerImpl.

Destinado a uso interno pela API.

Jogador

 Player(
  const Player & copy_from
)

Cria uma cópia de um jogador.

Jogador

 Player(
  Player && move_from
)

Move um jogador para um novo.

Título

const std::string & Title() const 

Recupera o título do player.

Isso é baseado nas ações que o jogador realizou no ecossistema de jogos do Google Play. Nem todos os jogadores têm títulos, e o título de um jogador pode mudar com o tempo. Se um jogador não tiver um título, Title() vai retornar uma string vazia.

Válido

bool Valid() const 

Retorna "true" quando o player retornado é preenchido com dados e acompanhado por um status de resposta bem-sucedido. Retorna "false" para um player criado pelo usuário sem preenchimento ou para um preenchido acompanhado por um status de resposta com falha.

Ele precisa retornar "true" para que as funções getter desse objeto sejam utilizáveis.

operator=

Player & operator=(
  const Player & copy_from
)

Atribui esse jogador copiando de outro.

operator=

Player & operator=(
  Player && move_from
)

Atribui esse valor de Player movendo outro para ele.

~Player

 ~Player()