gpg::AchievementManager

#include <achievement_manager.h>

Consente di acquisire e impostare vari dati relativi agli obiettivi.

Riepilogo

Tipi pubblici
FetchAllCallback typedef
std::function< void(const FetchAllResponse &)>
Definisce un tipo di callback che riceve un FetchAllResponse.
FetchCallback typedef
std::function< void(const FetchResponse &)>
Definisce un tipo di callback che riceve un FetchResponse.
ShowAllUICallback typedef
std::function< void(const UIStatus &)>
Definisce un tipo di callback che riceve un UIStatus.

Funzioni pubbliche
Fetch(const std::string & achievement_id, FetchCallback callback)
void
Carica in modo asincrono i dati relativi a un obiettivo specifico per il player attualmente connesso.
Fetch(DataSource data_source, const std::string & achievement_id, FetchCallback callback)
void
Carica in modo asincrono i dati relativi a un obiettivo specifico per il player attualmente connesso.
FetchAll(FetchAllCallback callback)
void
Carica in modo asincrono tutti i dati relativi agli obiettivi del giocatore che ha eseguito l'accesso.
FetchAll(DataSource data_source, FetchAllCallback callback)
void
Carica in modo asincrono tutti i dati relativi agli obiettivi del giocatore che ha eseguito l'accesso.
FetchAllBlocking()
Carica in modo sincrono tutti i dati relativi agli obiettivi per il giocatore che ha eseguito l'accesso, restituendo direttamente FetchAllResponse.
FetchAllBlocking(DataSource data_source)
Carica in modo sincrono tutti i dati relativi agli obiettivi per il giocatore che ha eseguito l'accesso, restituendo direttamente FetchAllResponse.
FetchAllBlocking(Timeout timeout)
Carica in modo sincrono tutti i dati relativi agli obiettivi per il giocatore che ha eseguito l'accesso, restituendo direttamente FetchAllResponse.
FetchAllBlocking(DataSource data_source, Timeout timeout)
Carica in modo sincrono tutti i dati relativi agli obiettivi per il giocatore che ha eseguito l'accesso, restituendo direttamente FetchAllResponse.
FetchBlocking(const std::string & achievement_id)
Carica in modo sincrono i dati relativi a un obiettivo specifico, identificato da un ID stringa, per il player attualmente connesso, restituisce direttamente FetchResponse.
FetchBlocking(DataSource data_source, const std::string & achievement_id)
Carica in modo sincrono i dati relativi a un obiettivo specifico, identificato da un ID stringa, per il player attualmente connesso, restituisce direttamente FetchResponse.
FetchBlocking(Timeout timeout, const std::string & achievement_id)
Carica in modo sincrono i dati relativi a un obiettivo specifico, identificato da un ID stringa, per il player attualmente connesso, restituisce direttamente FetchResponse.
FetchBlocking(DataSource data_source, Timeout timeout, const std::string & achievement_id)
Carica in modo sincrono i dati relativi a un obiettivo specifico, identificato da un ID stringa, per il player attualmente connesso, restituisce direttamente FetchResponse.
Increment(const std::string & achievement_id)
void
Incrementa un obiettivo in base al numero di passi specificato.
Increment(const std::string & achievement_id, uint32_t steps)
void
Incrementa un obiettivo in base al numero di passi specificato.
Reveal(const std::string & achievement_id)
void
Mostra un obiettivo nascosto al giocatore che ha eseguito l'accesso.
SetStepsAtLeast(const std::string & achievement_id, uint32_t steps)
void
Imposta un obiettivo in modo che abbia completato almeno il numero di passaggi specificato.
ShowAllUI(ShowAllUICallback callback)
void
Presenta all'utente una UI che mostra informazioni su tutti gli obiettivi.
ShowAllUI()
void
Deprecato. Preferisco ShowAllUI(ShowAllUICallback callback). Presenta all'utente un'interfaccia utente che mostra informazioni su tutti gli obiettivi. L'UI viene mostrata in modo asincrono su tutte le piattaforme.
ShowAllUIBlocking()
Presenta all'utente una UI che mostra informazioni su tutti gli obiettivi.
ShowAllUIBlocking(Timeout timeout)
Presenta all'utente una UI che mostra informazioni su tutti gli obiettivi.
Unlock(const std::string & achievement_id)
void
Sblocca un obiettivo per il giocatore che attualmente ha eseguito l'accesso.

Strutture
gpg::AchievementManager::FetchAllResponse

Contiene tutti i dati relativi a tutti gli obiettivi, insieme allo stato delle risposte.

gpg::AchievementManager::FetchResponse

Contiene i dati e lo stato delle risposte per un singolo obiettivo.

Tipi pubblici

FetchAllCallback

std::function< void(const FetchAllResponse &)> FetchAllCallback

Definisce un tipo di callback che riceve un FetchAllResponse.

Questo tipo di callback viene fornito alle funzioni FetchAll(*) riportate di seguito.

FetchCallback

std::function< void(const FetchResponse &)> FetchCallback

Definisce un tipo di callback che riceve un FetchResponse.

Questo tipo di callback viene fornito alle funzioni Fetch(*) riportate di seguito.

ShowAllUICallback

std::function< void(const UIStatus &)> ShowAllUICallback

Definisce un tipo di callback che riceve un UIStatus.

Questo tipo di callback viene fornito alla funzione ShowAllUI* di seguito.

Funzioni pubbliche

Recupero

void Fetch(
  const std::string & achievement_id,
  FetchCallback callback
)

Carica in modo asincrono i dati relativi a un obiettivo specifico per il player attualmente connesso.

Chiama l'elemento FetchCallback fornito al completamento dell'operazione. Se non specifichi data_source, questa chiamata di funzione equivale a chiamare Fetch(DataSource data_source, const std::string& id, FetchCallback), con data_source specificato come CACHE_OR_NETWORK.

Recupero

void Fetch(
  DataSource data_source,
  const std::string & achievement_id,
  FetchCallback callback
)

Carica in modo asincrono i dati relativi a un obiettivo specifico per il player attualmente connesso.

Chiama l'elemento FetchCallback fornito al completamento dell'operazione. Specifica data_source come CACHE_OR_NETWORK o NETWORK_ONLY.

FetchAll

void FetchAll(
  FetchAllCallback callback
)

Carica in modo asincrono tutti i dati relativi agli obiettivi del giocatore che ha eseguito l'accesso.

Chiama l'elemento FetchAllCallback fornito al completamento dell'operazione. Se non specifichi data_source, questa chiamata di funzione equivale a chiamare FetchAll(DataSource data_source, FetchAllCallback), con data_source specificato come CACHE_OR_NETWORK.

FetchAll

void FetchAll(
  DataSource data_source,
  FetchAllCallback callback
)

Carica in modo asincrono tutti i dati relativi agli obiettivi del giocatore che ha eseguito l'accesso.

Chiama l'elemento FetchAllCallback fornito al completamento dell'operazione. Specifica data_source come CACHE_OR_NETWORK o NETWORK_ONLY.

FetchAllBlocking

FetchAllResponse FetchAllBlocking()

Carica in modo sincrono tutti i dati relativi agli obiettivi per il giocatore che ha eseguito l'accesso, restituendo direttamente FetchAllResponse.

Se specifichi né data_source né timeout, questa chiamata di funzione equivale a chiamare FetchAllResponse FetchAllBlocking(DataSource data_source, Timeout timeout), con data_source specificato come CACHE_OR_NETWORK e timeout come 10 anni.

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  DataSource data_source
)

Carica in modo sincrono tutti i dati relativi agli obiettivi per il giocatore che ha eseguito l'accesso, restituendo direttamente FetchAllResponse.

Specifica data_source come CACHE_OR_NETWORK o NETWORK_ONLY. Se non specifichi timeout, questa chiamata di funzione equivale a chiamare FetchAllBlocking FetchAllResponse(DataSource data_source, Timeout timeout), con il valore data_source specificato e con timeout specificato come 10 anni.

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  Timeout timeout
)

Carica in modo sincrono tutti i dati relativi agli obiettivi per il giocatore che ha eseguito l'accesso, restituendo direttamente FetchAllResponse.

Specifica timeout come numero arbitrario di millisecondi. Se non specifichi data_source, questa chiamata di funzione equivale a chiamare FetchAllResponse FetchAllBlocking(DataSource data_source, Timeout timeout), in cui data_source specificato come CACHE_OR_NETWORK e timeout contenente il valore specificato.

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  DataSource data_source,
  Timeout timeout
)

Carica in modo sincrono tutti i dati relativi agli obiettivi per il giocatore che ha eseguito l'accesso, restituendo direttamente FetchAllResponse.

Specifica data_source come CACHE_OR_NETWORK o NETWORK_ONLY. Specifica il timeout come numero arbitrario di millisecondi.

FetchBlocking

FetchResponse FetchBlocking(
  const std::string & achievement_id
)

Carica in modo sincrono i dati relativi a un obiettivo specifico, identificato da un ID stringa, per il player attualmente connesso, restituisce direttamente FetchResponse.

Se lasci data_source e timeout non specificati, questa chiamata di funzione equivale a chiamare FetchResponse FetchBlocking(DataSource data_source, Timeout timeout, const std::string& id), con data_source specificato come CACHE_OR_NETWORK e timeout specificato come 10 anni.

FetchBlocking

FetchResponse FetchBlocking(
  DataSource data_source,
  const std::string & achievement_id
)

Carica in modo sincrono i dati relativi a un obiettivo specifico, identificato da un ID stringa, per il player attualmente connesso, restituisce direttamente FetchResponse.

Specifica data_source come CACHE_OR_NETWORK o NETWORK_ONLY. Se lasci timeout non specificato, questa chiamata di funzione equivale a chiamare FetchResponse FetchBlocking(DataSource data_source, Timeout timeout, const std::string& id), con il valore data_source specificato e con timeout specificato come 10 anni.

FetchBlocking

FetchResponse FetchBlocking(
  Timeout timeout,
  const std::string & achievement_id
)

Carica in modo sincrono i dati relativi a un obiettivo specifico, identificato da un ID stringa, per il player attualmente connesso, restituisce direttamente FetchResponse.

Specifica timeout come numero arbitrario di millisecondi. Se il criterio data_source non viene specificato, la chiamata di funzione sarà equivalente alla chiamata di FetchResponse FetchBlocking(DataSource data_source, Timeout timeout, const std::string& id), con data_source specificato come CACHE_OR_NETWORK e timeout contenente il valore specificato.

FetchBlocking

FetchResponse FetchBlocking(
  DataSource data_source,
  Timeout timeout,
  const std::string & achievement_id
)

Carica in modo sincrono i dati relativi a un obiettivo specifico, identificato da un ID stringa, per il player attualmente connesso, restituisce direttamente FetchResponse.

Specifica data_source come CACHE_OR_NETWORK o NETWORK_ONLY. Specifica timeout come numero arbitrario di millisecondi.

Incremento

void Increment(
  const std::string & achievement_id
)

Incrementa un obiettivo in base al numero di passi specificato.

Se lasci l'incremento non definito, il relativo valore viene impostato su 1 per impostazione predefinita. L'obiettivo deve essere un obiettivo incrementale. Quando un obiettivo raggiunge il numero massimo di passi, viene sbloccato automaticamente. Eventuali ulteriori incrementi vengono ignorati.

Incremento

void Increment(
  const std::string & achievement_id,
  uint32_t steps
)

Incrementa un obiettivo in base al numero di passi specificato.

L'obiettivo deve essere un obiettivo incrementale. Quando un obiettivo raggiunge almeno il numero massimo di passi, viene sbloccato automaticamente. Eventuali ulteriori incrementi verranno ignorati.

Mostra

void Reveal(
  const std::string & achievement_id
)

Mostra un obiettivo nascosto al giocatore che ha eseguito l'accesso.

Se l'obiettivo è già stato sbloccato, questa operazione non avrà alcun effetto.

SetStepsAtLeast

void SetStepsAtLeast(
  const std::string & achievement_id,
  uint32_t steps
)

Imposta un obiettivo in modo che abbia completato almeno il numero di passaggi specificato.

Richiamare questo metodo mentre l'obiettivo ha già più passi rispetto al valore indicato è un'operazione automatica. Quando l'obiettivo raggiunge il numero massimo di passi, l'obiettivo viene sbloccato automaticamente e qualsiasi altra operazione di modifica viene ignorata.

ShowAllUI

void ShowAllUI(
  ShowAllUICallback callback
)

Presenta all'utente una UI che mostra informazioni su tutti gli obiettivi.

Chiama ShowAllUICallback in modo asincrono.

ShowAllUI

void ShowAllUI()

Deprecato. Preferisco ShowAllUI(ShowAllUICallback callback). Presenta all'utente un'interfaccia utente che mostra informazioni su tutti gli obiettivi. L'UI viene mostrata in modo asincrono su tutte le piattaforme.

ShowAllUIBlocking

UIStatus ShowAllUIBlocking()

Presenta all'utente una UI che mostra informazioni su tutti gli obiettivi.

Restituisce in modo sincrono un UIStatus. Se non specifichi timeout, questa chiamata di funzione equivale a chiamare ShowAllUIBlocking(Timeout timeout) con timeout specificato come 10 anni.

ShowAllUIBlocking

UIStatus ShowAllUIBlocking(
  Timeout timeout
)

Presenta all'utente una UI che mostra informazioni su tutti gli obiettivi.

Restituisce in modo sincrono un UIStatus. Specifica timeout come numero arbitrario di millisecondi.

Sblocca

void Unlock(
  const std::string & achievement_id
)

Sblocca un obiettivo per il giocatore che attualmente ha eseguito l'accesso.

Se l'obiettivo è nascosto, l'SDK lo rivela anche.