gpg::Achievement

#include <achievement.h>

Uma única estrutura de dados que permite acessar dados sobre o status de uma conquista específica.

Resumo

Os dados são de dois tipos: específicos do usuário (por exemplo, se o usuário desbloqueou a conquista etc.) e globais (por exemplo, o nome da conquista).

Construtores e destrutores

Achievement()
Achievement(std::shared_ptr< const AchievementImpl > impl)
Cria uma conquista de um shared_ptr para um AchievementImpl.Destinado a uso interno pela API.
Achievement(const Achievement & copy_from)
Cria uma cópia de uma Conquista.
Achievement(Achievement && move_from)
Move uma conquista.
~Achievement()

Funções públicas

CurrentSteps() const
uint32_t
Retorna o número de etapas que o jogador realizou para desbloquear uma conquista incremental.
Description() const
const std::string &
Retorna uma descrição concisa da sua conquista.
Id() const
const std::string &
Retorna a string exclusiva gerada pelo Google Play Developer Console.
LastModified() const Descontinuado. Prefira LastModifiedTime.
LastModifiedTime() const
Retorna a hora em que a entrada foi modificada pela última vez (expressa em milissegundos desde a época Unix).
Name() const
const std::string &
Retorna o nome abreviado da conquista.
RevealedIconUrl() const
const std::string &
Retorna o URL que leva à imagem do ícone revelado para esta Conquista.
State() const
Retorna o estado da conquista: HIDDEN, REVEALED ou UNLOCKED.
TotalSteps() const
uint32_t
Retorna o número total de etapas necessárias para que o jogador desbloqueie uma conquista incremental.
Type() const
Retorna o tipo de conquista: INCREMENTAL ou STANDARD.
UnlockedIconUrl() const
const std::string &
Retorna o URL que leva à imagem do ícone desbloqueado para esta Conquista.
Valid() const
bool
Retorna "true" quando a conquista retornada é preenchida com dados e é acompanhada por um status de resposta bem-sucedido. Retorna "false" para uma conquista criada pelo usuário sem preenchimento ou para uma preenchida acompanhada por um status de resposta com falha.
XP() const
uint64_t
O número de pontos de experiência concedidos por essa conquista.
operator=(const Achievement & copy_from)
Atribui essa Conquista copiando de outra.
operator=(Achievement && move_from)
Atribui essa Conquista movendo outra para ela.

Funções públicas

Conquista

 Achievement()

Conquista

 Achievement(
  std::shared_ptr< const AchievementImpl > impl
)

Cria uma conquista de um shared_ptr para um AchievementImpl.Destinado a uso interno pela API.

Conquista

 Achievement(
  const Achievement & copy_from
)

Cria uma cópia de uma conquista.

Conquista

 Achievement(
  Achievement && move_from
)

Move uma conquista.

CurrentSteps

uint32_t CurrentSteps() const 

Retorna o número de etapas que o jogador realizou para desbloquear uma conquista incremental.

Ela só pode ser chamada quando Achievement::Valid() retornar "true".

Descrição

const std::string & Description() const 

Retorna uma descrição concisa da sua conquista.

Normalmente, informa ao jogador como ganhar a conquista. Até 500 caracteres. Ela só pode ser chamada quando Achievement::Valid() retornar "true".

ID

const std::string & Id() const 

Retorna a string exclusiva gerada pelo Google Play Developer Console.

Use-o para se referir a uma conquista no cliente do jogo. Ela só pode ser chamada quando Achievement::Valid() retornar "true".

LastModified

Timestamp LastModified() const 

Descontinuado. Prefira LastModifiedTime.

LastModifiedTime

Timestamp LastModifiedTime() const 

Retorna a hora em que a entrada foi modificada pela última vez (expressa em milissegundos desde a época Unix).

Ela só pode ser chamada quando Achievement::Valid() retornar "true".

Nome

const std::string & Name() const 

Retorna o nome abreviado da conquista.

Até 100 caracteres. Ela só pode ser chamada quando Achievement::Valid() retornar "true".

RevealedIconUrl

const std::string & RevealedIconUrl() const 

Retorna o URL que leva à imagem do ícone revelado para esta Conquista.

Esse ícone é mostrado quando a Conquista foi revelada, mas ainda não foi desbloqueada. Essa função só pode ser chamada quando Achievement::Valid() retornar "true".

Estado

AchievementState State() const 

Retorna o estado da conquista: HIDDEN, REVEALED ou UNLOCKED.

Ela só pode ser chamada quando Achievement::Valid() retornar "true". Confira mais informações aqui.

TotalSteps

uint32_t TotalSteps() const 

Retorna o número total de etapas necessárias para que o jogador desbloqueie uma conquista incremental.

Ela só pode ser chamada quando Achievement::Valid() retornar "true".

Tipo

AchievementType Type() const 

Retorna o tipo de conquista: INCREMENTAL ou STANDARD.

Ela só pode ser chamada quando Achievement::Valid() retornar "true". Confira mais informações aqui.

UnlockedIconUrl

const std::string & UnlockedIconUrl() const 

Retorna o URL que leva à imagem do ícone desbloqueado para esta Conquista.

Esse ícone é mostrado quando a Conquista é desbloqueada (e, portanto, revelada). Essa função só pode ser chamada quando Achievement::Valid() retornar "true".

Válido

bool Valid() const 

Retorna "true" quando a conquista retornada é preenchida com dados e acompanhada de um status de resposta bem-sucedido. Retorna "false" para uma conquista criada pelo usuário sem preenchimento ou para uma preenchida acompanhada de um status de resposta com falha.

Ele precisa ser verdadeiro para que as funções getter desse prêmio (ID, nome, descrição etc.) sejam utilizáveis.

XP

uint64_t XP() const 

O número de pontos de experiência concedidos por essa conquista.

Ela só pode ser chamada quando Achievement::Valid() retornar "true".

operator=

Achievement & operator=(
  const Achievement & copy_from
)

Atribui essa Conquista copiando de outra.

operator=

Achievement & operator=(
  Achievement && move_from
)

Atribui essa Conquista movendo outra para ela.

~Conquista

 ~Achievement()