Spielstatistiken für Android-Spiele

In diesem Leitfaden erfahren Sie, wie Sie die Spielstatistiken-APIs in einer Android-App verwenden, um Spielstatistiken in Ihrem Spiel freizuschalten und anzuzeigen. Die APIs befinden sich in den com.google.android.gms.games und com.google.android.gms.games.playergameevent Paketen.

Hinweis

Wir empfehlen Ihnen, sich mit den Konzepten für Spielstatistiken vertraut zu machen, sofern Sie dies nicht schon getan haben.

Bevor Sie mit dem Programmieren mit der Spielstatistiken-API beginnen, sollten Sie Folgendes tun:

Spielstatistiken-Client abrufen

Bevor Sie die Spielstatistiken-API verwenden können, muss Ihr Spiel zuerst ein GameStatsClient Objekt abrufen. Rufen Sie dazu die Games.getGameStatsClient() Methode auf und übergeben Sie die Aktivität.

Clientseitige Integration

Bei der clientseitigen Integration für PlayerGameEvent müssen Sie das Ereignisobjekt an den Triggerpunkten im Java SDK erstellen und es mithilfe der vom SDK bereitgestellten Uploadfunktionen senden.

Für das Ereignis progressUpdate müssen Sie den aktualisierten Fortschritt mit der Eigenschaft currentProgress und zusätzlichen definierten Eigenschaften aufzeichnen und mithilfe der vom SDK bereitgestellten Uploadfunktionen senden.

Ereignisse

Die clientseitige Integration für PlayerGameEvent umfasst Folgendes:

Spielereignis erstellen

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

progressUpdate-Spielereignis erstellen

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

Ereignis aufzeichnen und hochladen

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