gpg::AchievementManager

#include <achievement_manager.h>

Recebe e define vários dados relacionados a conquistas.

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 forma 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 forma assíncrona os dados de uma conquista específica para o jogador conectado no momento.
FetchAll(FetchAllCallback callback)
void
Carrega de forma assíncrona todos os dados de conquistas do jogador conectado no momento.
FetchAll(DataSource data_source, FetchAllCallback callback)
void
Carrega de forma assíncrona todos os dados de conquistas do jogador conectado no momento.
FetchAllBlocking()
Carrega de forma síncrona todos os dados de conquistas do jogador conectado no momento, retornando diretamente o FetchAllResponse.
FetchAllBlocking(DataSource data_source)
Carrega de forma síncrona todos os dados de conquistas do jogador conectado no momento, retornando diretamente o FetchAllResponse.
FetchAllBlocking(Timeout timeout)
Carrega de forma síncrona todos os dados de conquistas do jogador conectado no momento, retornando diretamente o FetchAllResponse.
FetchAllBlocking(DataSource data_source, Timeout timeout)
Carrega de forma síncrona todos os dados de conquistas do jogador conectado no momento, retornando diretamente o FetchAllResponse.
FetchBlocking(const std::string & achievement_id)
Carrega de forma síncrona os dados de uma conquista específica, identificada pelo ID da string, para o jogador conectado no momento e retorna diretamente o FetchResponse.
FetchBlocking(DataSource data_source, const std::string & achievement_id)
Carrega de forma síncrona os dados de uma conquista específica, identificada pelo ID da string, para o jogador conectado no momento e retorna diretamente o FetchResponse.
FetchBlocking(Timeout timeout, const std::string & achievement_id)
Carrega de forma síncrona os dados de uma conquista específica, identificada pelo ID da string, para o jogador conectado no momento e retorna diretamente o FetchResponse.
FetchBlocking(DataSource data_source, Timeout timeout, const std::string & achievement_id)
Carrega de forma síncrona os dados de uma conquista específica, identificada pelo ID da string, para o jogador conectado no momento e retorna diretamente o FetchResponse.
Increment(const std::string & achievement_id)
void
Incrementa uma conquista pelo número de etapas indicado.
Increment(const std::string & achievement_id, uint32_t steps)
void
Incrementa uma conquista pelo número de etapas 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 ter pelo menos o número indicado de etapas concluídas.
ShowAllUI(ShowAllUICallback callback)
void
Apresenta ao usuário uma interface que mostra informações sobre todos os feitos.
ShowAllUI()
void
Descontinuado. Prefira ShowAllUI(ShowAllUICallback callback). Apresenta uma interface ao usuário que mostra informações sobre todos os feitos. A interface é mostrada de forma assíncrona em todas as plataformas.
ShowAllUIBlocking()
Apresenta ao usuário uma interface que mostra informações sobre todos os feitos.
ShowAllUIBlocking(Timeout timeout)
Apresenta ao usuário uma interface que mostra informações sobre todos os feitos.
Unlock(const std::string & achievement_id)
void
Desbloqueia uma conquista para o jogador conectado no momento.

Estruturas

gpg::AchievementManager::FetchAllResponse

Contém todos os dados de todos os prêmios, além de um status de resposta.

gpg::AchievementManager::FetchResponse

Contém dados e o status de resposta de 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

Obter

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

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

Chama o FetchCallback fornecido após a conclusão da operação. Não especificar data_source faz com que essa chamada de função seja equivalente a chamar Fetch(DataSource data_source, const std::string& id, FetchCallback), com data_source especificado como CACHE_OR_NETWORK.

Obter

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

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

Chama o FetchCallback fornecido após a conclusão da operação. Especifique data_source como CACHE_OR_NETWORK ou NETWORK_ONLY.

FetchAll

void FetchAll(
  FetchAllCallback callback
)

Carrega de forma assíncrona todos os dados de conquistas do jogador conectado no momento.

Chama o FetchAllCallback fornecido após a conclusão da operação. Não especificar data_source faz com que essa chamada de função seja 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 forma assíncrona todos os dados de conquistas do jogador conectado no momento.

Chama o FetchAllCallback fornecido após a 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 conquistas do jogador conectado no momento, retornando diretamente o FetchAllResponse.

Especificar data_source ou timeout faz com que essa chamada de função seja 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 conquistas do jogador conectado no momento, retornando diretamente o FetchAllResponse.

Especifique data_source como CACHE_OR_NETWORK ou NETWORK_ONLY. Não especificar timeout faz com que essa chamada de função seja equivalente a chamar FetchAllBlocking FetchAllResponse(DataSource data_source, Timeout timeout), com o valor especificado de data_source e timeout especificado como 10 anos.

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  Timeout timeout
)

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

Especifique timeout como um número arbitrário de milissegundos. Não especificar data_source faz com que essa chamada de função seja 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 conquistas do jogador conectado no momento, retornando diretamente o FetchAllResponse.

Especifique data_source como CACHE_OR_NETWORK ou NETWORK_ONLY. Especifique 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 de uma conquista específica, identificada pelo ID da string, para o jogador conectado no momento e retorna diretamente o FetchResponse.

Deixar data_source e timeout sem especificação faz com que essa chamada de função seja 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 de uma conquista específica, identificada pelo ID da string, para o jogador conectado no momento e retorna diretamente o FetchResponse.

Especifique data_source como CACHE_OR_NETWORK ou NETWORK_ONLY. Deixar timeout indefinido faz com que essa chamada de função seja equivalente a chamar FetchResponse FetchBlocking(DataSource data_source, Timeout timeout, const std::string& id), com o valor especificado de data_source e timeout especificado como 10 anos.

FetchBlocking

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

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

Especifique timeout como um número arbitrário de milissegundos. Deixar data_source não especificado faz com que essa chamada de função seja 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 de uma conquista específica, identificada pelo ID da string, para o jogador conectado no momento e 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 etapas especificado.

Se o incremento não for definido, o valor padrão será 1. A conquista precisa ser incremental. Quando uma conquista atinge o número máximo de etapas, ela é desbloqueada automaticamente. Todos os incrementos adicionais são ignorados.

Incremento

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

Incrementa uma conquista pelo número de etapas especificado.

A conquista precisa ser incremental. Quando uma conquista atinge pelo menos o número máximo de etapas, ela é desbloqueada automaticamente. Todos os incrementos adicionais 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 vai ter efeito.

SetStepsAtLeast

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

Defina uma conquista para ter pelo menos o número indicado de etapas concluídas.

Chamar esse método enquanto a conquista já tem mais etapas do que o valor fornecido não faz nada. Quando a conquista atinge o número máximo de etapas, ela é 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 todos os feitos.

Ele chama ShowAllUICallback de forma assíncrona.

ShowAllUI

void ShowAllUI()

Descontinuado. Prefira ShowAllUI(ShowAllUICallback callback). Apresenta uma interface ao usuário que mostra informações sobre todos os feitos. 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 todos os feitos.

Ele retorna de forma síncrona um UIStatus. Não especificar timeout faz com que essa chamada de função seja 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 todos os feitos.

Ele retorna de forma síncrona um UIStatus. 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 revelará.