gpg:: Conquista
#include <achievement.h>
Uma única estrutura de dados que permite acessar dados sobre o status de uma conquista específica.
Resumo
Os dados incluem 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 existente.
|
|
Achievement(Achievement && move_from)
Move uma Conquista existente.
|
|
~Achievement()
|
Funções públicas |
|
---|---|
CurrentSteps() const
|
uint32_t
Retorna o número de passos que o jogador deu 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 que o Console do desenvolvedor do Google Play gerou anteriormente.
|
LastModified() const
|
Descontinuado. Dar preferência a LastModifiedTime |
LastModifiedTime() const
|
Retorna o horário da última modificação da entrada (expressa em milissegundos desde a época Unix).
|
Name() const
|
const std::string &
Retorna o nome curto da conquista.
|
RevealedIconUrl() const
|
const std::string &
Retorna o URL que leva à imagem do ícone revelado dessa Conquista.
|
State() const
|
Retorna o estado da conquista:
HIDDEN , REVEALED ou UNLOCKED . |
TotalSteps() const
|
uint32_t
Retorna o número total de passos necessários para que o jogador desbloqueie uma determinada 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 essa conquista.
|
Valid() const
|
bool
Retorna verdadeiro quando a conquista retornada é preenchida com dados e é acompanhada por um status de resposta bem-sucedida; falso para uma conquista criada pelo usuário não preenchida ou para uma preenchida acompanhada por um status de resposta de 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 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 )
Constrói uma Conquista de um shared_ptr
para um AchievementImpl
.Destinado ao uso interno pela API.
CurrentSteps
uint32_t CurrentSteps() const
Retorna o número de passos que o jogador deu para desbloquear uma conquista incremental.
Ele só pode ser chamado quando Achievement::Valid() retorna "true".
Descrição
const std::string & Description() const
Retorna uma descrição concisa da sua conquista.
Geralmente, informa ao jogador como conquistar a conquista. Até 500 caracteres. Ele só pode ser chamado quando Achievement::Valid() retorna "true".
ID
const std::string & Id() const
Retorna a string exclusiva que o Console do desenvolvedor do Google Play gerou anteriormente.
Use-a para se referir a uma conquista no cliente do jogo. Ele só pode ser chamado quando Achievement::Valid() retorna "true".
LastModifiedTime
Timestamp LastModifiedTime() const
Retorna o horário da última modificação da entrada (expressa em milissegundos desde a época Unix).
Ele só pode ser chamado quando Achievement::Valid() retorna "true".
Nome
const std::string & Name() const
Retorna o nome curto da conquista.
Até 100 caracteres. Ele só pode ser chamado quando Achievement::Valid() retorna "true".
RevealedIconUrl
const std::string & RevealedIconUrl() const
Retorna o URL que leva à imagem do ícone revelado dessa Conquista.
Esse ícone aparece quando a Conquista foi revelada, mas ainda não desbloqueada. Essa função só pode ser chamada quando Achievement::Valid() retorna "true".
Estado
AchievementState State() const
Retorna o estado da conquista: HIDDEN
, REVEALED
ou UNLOCKED
.
Ele só pode ser chamado quando Achievement::Valid() retorna "true". Veja mais informações neste link.
TotalSteps
uint32_t TotalSteps() const
Retorna o número total de passos necessários para que o jogador desbloqueie uma determinada conquista incremental.
Ele só pode ser chamado quando Achievement::Valid() retorna "true".
Tipo
AchievementType Type() const
Retorna o tipo de conquista: INCREMENTAL
ou STANDARD
.
Ele só pode ser chamado quando Achievement::Valid() retorna "true". Veja mais informações neste link.
UnlockedIconUrl
const std::string & UnlockedIconUrl() const
Retorna o URL que leva à imagem do ícone desbloqueado para essa conquista.
Esse ícone é exibido quando a Conquista é desbloqueada (e, portanto, também revelada). Essa função só pode ser chamada quando Achievement::Valid() retorna "true".
Válida
bool Valid() const
Retorna verdadeiro quando a conquista retornada é preenchida com dados e é acompanhada por um status de resposta bem-sucedida; falso para uma conquista criada pelo usuário não preenchida ou para uma preenchida acompanhada por um status de resposta de falha.
Ela precisa ser verdadeira para que as funções getter nessa conquista (ID, nome, descrição etc.) possam ser usadas.
XP
uint64_t XP() const
É o número de pontos de experiência concedidos por essa conquista.
Ele só pode ser chamado quando Achievement::Valid() retorna "true".
operador=
Achievement & operator=( const Achievement & copy_from )
Atribui essa conquista copiando outra.
operador=
Achievement & operator=( Achievement && move_from )
Atribui essa conquista movendo outra para ela.
Conquista
~Achievement()