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)
|
|
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.
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".
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()