Estadísticas de juegos para juegos de Android

En esta guía, se muestra cómo usar las APIs de estadísticas de juegos en una aplicación para Android para desbloquear y mostrar estadísticas de juegos en el juego. Se pueden encontrar las APIs en los paquetes com.google.android.gms.games y com.google.android.gms.games.playergameevent.

Antes de comenzar

Si aún no lo hiciste, puede resultarte útil consultar los conceptos de juegos de estadísticas de juegos.

Antes de comenzar a programar con la API de estadísticas de juegos, haz lo siguiente:

Cómo obtener un cliente de estadísticas de juegos

Para comenzar a usar la API de estadísticas de juegos, el juego primero debe obtener un GameStatsClient objeto. Para ello, llama al Games.getGameStatsClient() método y pasa la actividad.

Integración del cliente

La integración del cliente para PlayerGameEvent implicaría que compiles el objeto de evento en el SDK de Java, en los puntos de activación y los envíes con las funciones de carga que proporciona el SDK.

Del mismo modo, para el evento progressUpdate, registra el progreso actualizado con la propiedad currentProgress con propiedades definidas adicionales y envíalas con las funciones de carga que proporciona el SDK.

Eventos

La integración del cliente para PlayerGameEvent es la siguiente:

Cómo compilar el evento de juego del jugador

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 ...

Cómo compilar el evento de juego del jugador 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 ...

Cómo registrar eventos y subirlos

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