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)
Crea un Obiettivo da shared_ptr a AchievementImpl.Destinato all'uso interno da parte dell'API.
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.

Obiettivo

 Achievement(
  const Achievement & copy_from
)

Crea una copia di un obiettivo esistente.

Obiettivo

 Achievement(
  Achievement && move_from
)

Sposta un Obiettivo esistente.

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.

LastModified

Timestamp LastModified() const

Deprecato. Preferisco LastModifiedTime.

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