Estatísticas do jogo para Android

Este guia mostra como usar as APIs de estatísticas do jogo em um app Android para desbloquear e exibir estatísticas do jogo no seu jogo. As APIs podem ser encontradas nos com.google.android.gms.games e com.google.android.gms.games.playergameevent pacotes.

Antes de começar

Caso ainda não tenha feito isso, recomendamos consultar os conceitos de estatísticas do jogo.

Antes de começar a programar usando a API de estatísticas do jogo:

Acessar um cliente de estatísticas de jogos

Para começar a usar a API Game Stats, o jogo precisa incluir um GameStatsClient objeto. Para isso, chame o Games.getGameStatsClient() método e transmita a atividade.

Integração no lado do cliente

A integração no lado do cliente para PlayerGameEvent envolve a criação do objeto de evento no SDK Java, nos pontos de acionamento e o envio deles usando as funções de upload fornecidas pelo SDK.

Da mesma forma, para o evento progressUpdate, registre o progresso atualizado usando a propriedade currentProgress com outras propriedades definidas e envie-as usando as funções de upload fornecidas pelo SDK.

Eventos

A integração no lado do cliente para PlayerGameEvent é:

Criar evento de jogo do player

Java


// Build the PlayerGameEvent
PlayerGameEvent event = new PlayerGameEvent.Builder("matchCompleted")
  .addProperty("matchId", "Match_A")
  .addProperty("gameMode", "Battle_B")
  .addProperty("mapId", "Location_XYZ")
  .addProperty("isWinner", true)
  .addProperty("playerElimination", 2)
  .build();

List events = new ArrayList<>();
// ... populate list ...

Criar evento de jogo do player progressUpdate

Java


// Build the PlayerGameEvent
PlayerGameEvent event = new PlayerGameEvent.Builder("progressUpdate")
  .addProperty("currentProgress", 52)
  // Add other properties if needed
  .build();

List events = new ArrayList<>();
// ... populate list ...

Registrar evento e fazer upload

Java


// Buffers the event locally.
client.recordEvent(event);

// Buffers the events locally, (List version)
client.recordEvents(events);

// This submits the events to PGS
client.requestEventsUpload();