gpg::AchievementManager

#include <achievement_manager.h>

Recebe e define vários dados relacionados à conquista.

Resumo

Tipos públicos

FetchAllCallback typedef
std::function< void(const FetchAllResponse &)>
Define um tipo de callback que recebe um FetchAllResponse.
FetchCallback typedef
std::function< void(const FetchResponse &)>
Define um tipo de callback que recebe um FetchResponse.
ShowAllUICallback typedef
std::function< void(const UIStatus &)>
Define um tipo de callback que recebe um UIStatus.

Funções públicas

Fetch(const std::string & achievement_id, FetchCallback callback)
void
Carrega de maneira assíncrona os dados de uma conquista específica para o jogador conectado no momento.
Fetch(DataSource data_source, const std::string & achievement_id, FetchCallback callback)
void
Carrega de maneira assíncrona os dados de uma conquista específica para o jogador conectado no momento.
FetchAll(FetchAllCallback callback)
void
Carrega de maneira assíncrona todos os dados de conquista do jogador conectado no momento.
FetchAll(DataSource data_source, FetchAllCallback callback)
void
Carrega de maneira assíncrona todos os dados de conquista do jogador conectado no momento.
FetchAllBlocking()
Carrega de forma síncrona todos os dados de conquista do jogador conectado no momento, retornando diretamente o FetchAllResponse.
FetchAllBlocking(DataSource data_source)
Carrega de forma síncrona todos os dados de conquista do jogador conectado no momento, retornando diretamente o FetchAllResponse.
FetchAllBlocking(Timeout timeout)
Carrega de forma síncrona todos os dados de conquista do jogador conectado no momento, retornando diretamente o FetchAllResponse.
FetchAllBlocking(DataSource data_source, Timeout timeout)
Carrega de forma síncrona todos os dados de conquista do jogador conectado no momento, retornando diretamente o FetchAllResponse.
FetchBlocking(const std::string & achievement_id)
Carrega de forma síncrona os dados para uma conquista específica, identificada pelo ID da string, para o jogador conectado no momento; retorna diretamente o FetchResponse.
FetchBlocking(DataSource data_source, const std::string & achievement_id)
Carrega de forma síncrona os dados para uma conquista específica, identificada pelo ID da string, para o jogador conectado no momento; retorna diretamente o FetchResponse.
FetchBlocking(Timeout timeout, const std::string & achievement_id)
Carrega de forma síncrona os dados para uma conquista específica, identificada pelo ID da string, para o jogador conectado no momento; retorna diretamente o FetchResponse.
FetchBlocking(DataSource data_source, Timeout timeout, const std::string & achievement_id)
Carrega de forma síncrona os dados para uma conquista específica, identificada pelo ID da string, para o jogador conectado no momento; retorna diretamente o FetchResponse.
Increment(const std::string & achievement_id)
void
Incrementa uma conquista pelo número de passos especificado.
Increment(const std::string & achievement_id, uint32_t steps)
void
Incrementa uma conquista pelo número de passos especificado.
Reveal(const std::string & achievement_id)
void
Revele uma conquista oculta para o jogador conectado no momento.
SetStepsAtLeast(const std::string & achievement_id, uint32_t steps)
void
Defina uma conquista para concluir pelo menos um determinado número de etapas.
ShowAllUI(ShowAllUICallback callback)
void
Apresenta ao usuário uma interface que mostra informações sobre todas as conquistas.
ShowAllUI()
void
Descontinuado. Prefere ShowAllUI(ShowAllUICallback callback). Mostra uma IU ao usuário que mostra informações sobre todas as conquistas. A interface é mostrada de forma assíncrona em todas as plataformas.
ShowAllUIBlocking()
Apresenta ao usuário uma interface que mostra informações sobre todas as conquistas.
ShowAllUIBlocking(Timeout timeout)
Apresenta ao usuário uma interface que mostra informações sobre todas as conquistas.
Unlock(const std::string & achievement_id)
void
Desbloqueia uma conquista para o jogador conectado no momento.

Estruturas

gpg::AchievementManager::FetchAllResponse

Mantém todos os dados de todas as conquistas, além de um status de resposta.

gpg::AchievementManager::FetchResponse

Contém dados e status de resposta para uma única conquista.

Tipos públicos

FetchAllCallback

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

Define um tipo de callback que recebe um FetchAllResponse.

Esse tipo de callback é fornecido às funções FetchAll(*) abaixo.

FetchCallback

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

Define um tipo de callback que recebe um FetchResponse.

Esse tipo de callback é fornecido às funções Fetch(*) abaixo.

ShowAllUICallback

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

Define um tipo de callback que recebe um UIStatus.

Esse tipo de callback é fornecido à função ShowAllUI* abaixo.

Funções públicas

Busca

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

Carrega de maneira assíncrona os dados de uma conquista específica para o jogador conectado no momento.

Chama o FetchCallback fornecido na conclusão da operação. Se você não especificar data_source, essa chamada de função será equivalente a chamar Fetch(DataSource data_source, const std::string& id, FetchCallback), com data_source especificado como CACHE_OR_NETWORK.

Busca

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

Carrega de maneira assíncrona os dados de uma conquista específica para o jogador conectado no momento.

Chama o FetchCallback fornecido na conclusão da operação. Especifique data_source como CACHE_OR_NETWORK ou NETWORK_ONLY.

FetchAll

void FetchAll(
  FetchAllCallback callback
)

Carrega de maneira assíncrona todos os dados de conquista do jogador conectado no momento.

Chama o FetchAllCallback fornecido na conclusão da operação. Se você não especificar data_source, essa chamada de função será equivalente a chamar FetchAll(DataSource data_source, FetchAllCallback), com data_source especificado como CACHE_OR_NETWORK.

FetchAll

void FetchAll(
  DataSource data_source,
  FetchAllCallback callback
)

Carrega de maneira assíncrona todos os dados de conquista do jogador conectado no momento.

Chama o FetchAllCallback fornecido na conclusão da operação. Especifique data_source como CACHE_OR_NETWORK ou NETWORK_ONLY.

FetchAllBlocking

FetchAllResponse FetchAllBlocking()

Carrega de forma síncrona todos os dados de conquista do jogador conectado no momento, retornando diretamente o FetchAllResponse.

Especificar não data_source nem timeout torna essa chamada de função equivalente a chamar FetchAllResponse FetchAllBlocking(DataSource data_source, Timeout timeout), com data_source especificado como CACHE_OR_NETWORK e timeout especificado como 10 anos.

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  DataSource data_source
)

Carrega de forma síncrona todos os dados de conquista do jogador conectado no momento, retornando diretamente o FetchAllResponse.

Especifique data_source como CACHE_OR_NETWORK ou NETWORK_ONLY. Se você não especificar timeout, essa chamada de função será equivalente a chamar FetchAllBlocking FetchAllResponse(DataSource data_source, Timeout timeout), com o valor data_source especificado, e timeout especificado como 10 anos.

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  Timeout timeout
)

Carrega de forma síncrona todos os dados de conquista do jogador conectado no momento, retornando diretamente o FetchAllResponse.

Especifique timeout como um número arbitrário de milissegundos. Se você não especificar data_source, essa chamada de função será equivalente a chamar FetchAllResponse FetchAllBlocking(DataSource data_source, Timeout timeout), com data_source especificado como CACHE_OR_NETWORK e timeout contendo o valor especificado.

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  DataSource data_source,
  Timeout timeout
)

Carrega de forma síncrona todos os dados de conquista do jogador conectado no momento, retornando diretamente o FetchAllResponse.

Especifique data_source como CACHE_OR_NETWORK ou NETWORK_ONLY. Especifica o tempo limite como um número arbitrário de milissegundos.

FetchBlocking

FetchResponse FetchBlocking(
  const std::string & achievement_id
)

Carrega de forma síncrona os dados para uma conquista específica, identificada pelo ID da string, para o jogador conectado no momento; retorna diretamente o FetchResponse.

Se data_source e timeout não forem especificados, essa chamada de função será equivalente a chamar FetchResponse FetchBlocking(DataSource data_source, Timeout timeout, const std::string& id), com data_source especificado como CACHE_OR_NETWORK e timeout especificado como 10 anos.

FetchBlocking

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

Carrega de forma síncrona os dados para uma conquista específica, identificada pelo ID da string, para o jogador conectado no momento; retorna diretamente o FetchResponse.

Especifique data_source como CACHE_OR_NETWORK ou NETWORK_ONLY. Se timeout não for especificado, essa chamada de função será equivalente a chamar FetchResponse FetchBlocking(DataSource data_source, Timeout timeout, const std::string& id), com o valor data_source especificado e timeout especificado como 10 anos.

FetchBlocking

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

Carrega de forma síncrona os dados para uma conquista específica, identificada pelo ID da string, para o jogador conectado no momento; retorna diretamente o FetchResponse.

Especifique timeout como um número arbitrário de milissegundos. Se data_source não for especificado, essa chamada de função será equivalente a chamar FetchResponse FetchBlocking(DataSource data_source, Timeout timeout, const std::string& id), com data_source especificado como CACHE_OR_NETWORK e timeout contendo o valor especificado.

FetchBlocking

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

Carrega de forma síncrona os dados para uma conquista específica, identificada pelo ID da string, para o jogador conectado no momento; retorna diretamente o FetchResponse.

Especifique data_source como CACHE_OR_NETWORK ou NETWORK_ONLY. Especifique timeout como um número arbitrário de milissegundos.

Incremento

void Increment(
  const std::string & achievement_id
)

Incrementa uma conquista pelo número de passos especificado.

Se o incremento for indefinido, o valor dele será definido como 1 por padrão. A conquista precisa ser uma conquista incremental. Quando uma conquista atinge o número máximo de passos, ela é desbloqueada automaticamente. Outros incrementos são ignorados.

Incremento

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

Incrementa uma conquista pelo número de passos especificado.

A conquista precisa ser uma conquista incremental. Quando uma conquista alcançar pelo menos o número máximo de passos, ela será desbloqueada automaticamente. Outros incrementos serão ignorados.

Revelação

void Reveal(
  const std::string & achievement_id
)

Revele uma conquista oculta para o jogador conectado no momento.

Se a conquista já tiver sido desbloqueada, isso não terá efeito.

SetStepsAtLeast

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

Defina uma conquista para concluir pelo menos um determinado número de etapas.

Chamar esse método enquanto a conquista já tiver mais etapas do que o valor fornecido é um ambiente autônomo. Quando a conquista atinge o número máximo de etapas, a conquista é desbloqueada automaticamente e todas as outras operações de mutação são ignoradas.

ShowAllUI

void ShowAllUI(
  ShowAllUICallback callback
)

Apresenta ao usuário uma interface que mostra informações sobre todas as conquistas.

Ela chama ShowAllUICallback de forma assíncrona.

ShowAllUI

void ShowAllUI()

Descontinuado. Prefere ShowAllUI(ShowAllUICallback callback). Mostra uma IU ao usuário que mostra informações sobre todas as conquistas. A interface é mostrada de forma assíncrona em todas as plataformas.

ShowAllUIBlocking

UIStatus ShowAllUIBlocking()

Apresenta ao usuário uma interface que mostra informações sobre todas as conquistas.

Ela retorna um UIStatus de forma síncrona. Se você não especificar timeout, essa chamada de função será equivalente a chamar ShowAllUIBlocking(Timeout timeout) com timeout especificado como 10 anos.

ShowAllUIBlocking

UIStatus ShowAllUIBlocking(
  Timeout timeout
)

Apresenta ao usuário uma interface que mostra informações sobre todas as conquistas.

Ela retorna um UIStatus de forma síncrona. Especifique timeout como um número arbitrário de milissegundos.

Desbloquear

void Unlock(
  const std::string & achievement_id
)

Desbloqueia uma conquista para o jogador conectado no momento.

Se a conquista estiver oculta, o SDK também a revela.