gpg:: Obiettivo
#include <achievement.h>
Una singola struttura di dati che consente di accedere ai dati sullo stato di un obiettivo specifico.
Riepilogo
I dati sono di due tipi: specifici per l'utente (ad es. se l'utente ha sbloccato l'obiettivo e così via) e globali (ad es. il nome dell'obiettivo).
Costruttori e distruttori |
|
---|---|
Achievement()
|
|
Achievement(std::shared_ptr< const AchievementImpl > impl)
|
|
Achievement(const Achievement & copy_from)
Crea una copia di un obiettivo esistente.
|
|
Achievement(Achievement && move_from)
Sposta un Obiettivo esistente.
|
|
~Achievement()
|
Funzioni pubbliche |
|
---|---|
CurrentSteps() const
|
uint32_t
Restituisce il numero di passi effettuati dal giocatore per sbloccare un obiettivo incrementale.
|
Description() const
|
const std::string &
Restituisce una descrizione concisa dell'obiettivo.
|
Id() const
|
const std::string &
Restituisce la stringa univoca generata in precedenza dalla Console per gli sviluppatori di Google Play.
|
LastModified() const
|
Deprecato. Preferisco LastModifiedTime. |
LastModifiedTime() const
|
Restituisce l'ora in cui la voce è stata modificata per l'ultima volta (espressa in millisecondi dall'epoca di Unix).
|
Name() const
|
const std::string &
Restituisce il nome breve dell'obiettivo.
|
RevealedIconUrl() const
|
const std::string &
Restituisce l'URL che indirizza all'immagine dell'icona visualizzata per l'obiettivo.
|
State() const
|
Restituisce lo stato dell'obiettivo:
HIDDEN , REVEALED o UNLOCKED . |
TotalSteps() const
|
uint32_t
Restituisce il numero di passaggi totali necessari al giocatore per sbloccare un determinato obiettivo incrementale.
|
Type() const
|
Restituisce il tipo di obiettivo:
INCREMENTAL o STANDARD . |
UnlockedIconUrl() const
|
const std::string &
Restituisce l'URL che rimanda all'immagine dell'icona sbloccata per l'obiettivo specificato.
|
Valid() const
|
bool
Restituisce true quando l'obiettivo restituito è completo di dati ed è accompagnato da uno stato di risposta riuscita; false per un obiettivo non completato creato dall'utente o uno stato completato accompagnato da uno stato di risposta non riuscita.
|
XP() const
|
uint64_t
Il numero di punti esperienza assegnati da questo obiettivo.
|
operator=(const Achievement & copy_from)
|
Assegna questo obiettivo copiandolo da un altro.
|
operator=(Achievement && move_from)
|
Assegna questo obiettivo spostandone un altro.
|
Funzioni pubbliche
Obiettivo
Achievement()
Obiettivo
Achievement( std::shared_ptr< const AchievementImpl > impl )
Crea un Obiettivo da shared_ptr
a AchievementImpl
.Destinato all'uso interno da parte dell'API.
CurrentSteps
uint32_t CurrentSteps() const
Restituisce il numero di passi effettuati dal giocatore per sbloccare un obiettivo incrementale.
Può essere chiamato solo quando Achievement::Valid() restituisce true.
Descrizione
const std::string & Description() const
Restituisce una descrizione concisa dell'obiettivo.
Di solito indica al giocatore come ottenere l'obiettivo. Può includere un massimo di 500 caratteri. Può essere chiamato solo quando Achievement::Valid() restituisce true.
ID
const std::string & Id() const
Restituisce la stringa univoca generata in precedenza dalla Console per gli sviluppatori di Google Play.
Utilizzalo per fare riferimento a un obiettivo nel client del gioco. Può essere chiamato solo quando Achievement::Valid() restituisce true.
LastModifiedTime
Timestamp LastModifiedTime() const
Restituisce l'ora in cui la voce è stata modificata per l'ultima volta (espressa in millisecondi dall'epoca di Unix).
Può essere chiamato solo quando Achievement::Valid() restituisce true.
Nome
const std::string & Name() const
Restituisce il nome breve dell'obiettivo.
Può includere un massimo di 100 caratteri. Può essere chiamato solo quando Achievement::Valid() restituisce true.
RevealedIconUrl
const std::string & RevealedIconUrl() const
Restituisce l'URL che indirizza all'immagine dell'icona visualizzata per l'obiettivo.
Questa icona deve essere visualizzata quando viene mostrato l'obiettivo, ma non è ancora stata sbloccata. Questa funzione può essere chiamata solo quando Achievement::Valid() restituisce true.
Stato
AchievementState State() const
Restituisce lo stato dell'obiettivo: HIDDEN
, REVEALED
o UNLOCKED
.
Può essere chiamato solo quando Achievement::Valid() restituisce true. Ulteriori informazioni sono disponibili qui.
TotalSteps
uint32_t TotalSteps() const
Restituisce il numero di passaggi totali necessari al giocatore per sbloccare un determinato obiettivo incrementale.
Può essere chiamato solo quando Achievement::Valid() restituisce true.
Tipo
AchievementType Type() const
Restituisce il tipo di obiettivo: INCREMENTAL
o STANDARD
.
Può essere chiamato solo quando Achievement::Valid() restituisce true. Ulteriori informazioni sono disponibili qui.
UnlockedIconUrl
const std::string & UnlockedIconUrl() const
Restituisce l'URL che rimanda all'immagine dell'icona sbloccata per l'obiettivo specificato.
Questa icona deve essere visualizzata quando l'obiettivo è stato sbloccato (e quindi mostrato). Questa funzione può essere chiamata solo quando Achievement::Valid() restituisce true.
Valida
bool Valid() const
Restituisce true quando l'obiettivo restituito è completo di dati ed è accompagnato da uno stato di risposta riuscita; false per un obiettivo non completato creato dall'utente o uno stato completato accompagnato da uno stato di risposta non riuscita.
Deve essere true affinché le funzioni getter di questo risultato (id, nome, descrizione e così via) siano utilizzabili.
XP
uint64_t XP() const
Il numero di punti esperienza assegnati da questo obiettivo.
Può essere chiamato solo quando Achievement::Valid() restituisce true.
operatore=
Achievement & operator=( const Achievement & copy_from )
Assegna questo obiettivo copiandolo da un altro.
operatore=
Achievement & operator=( Achievement && move_from )
Assegna questo obiettivo spostandone un altro.
~Obiettivo
~Achievement()