Statistiques de jeu pour les jeux Android

Ce guide explique comment utiliser les API Game Stats dans une application Android pour débloquer et afficher des statistiques de jeu dans votre jeu. Les API sont disponibles dans les packages com.google.android.gms.games et com.google.android.gms.games.playergameevent.

Avant de commencer

Si ce n'est pas déjà fait, n'hésitez pas à revoir les concepts de statistiques de jeu.

Avant de commencer à coder à l'aide de l'API Statistiques de jeu :

  • Suivez les instructions disponibles dans le guide Configurer le SDK des services Google Play afin d'installer et de configurer votre application pour qu'elle utilise les services Google Play Games.

  • Définissez les statistiques de jeu que vous souhaitez que votre jeu débloque ou affiche, en suivant les instructions du guide de la Google Play Console.

Obtenir un client Statistiques de jeu

Pour commencer à utiliser l'API Statistiques de jeu, votre jeu doit d'abord obtenir un GameStatsClient objet. Pour ce faire, appelez la Games.getGameStatsClient() méthode et transmettez l'activité.

Intégration côté client

L'intégration côté client pour PlayerGameEvent implique que vous créez l'objet d'événement dans le SDK Java, au niveau des points de déclenchement, et que vous l'envoyez à l'aide des fonctions d'importation fournies par le SDK.

De même, pour l'événement progressUpdate, enregistrez la progression mise à jour à l'aide de la propriété currentProgress avec des propriétés définies supplémentaires, puis envoyez-les à l'aide des fonctions d'importation fournies par le SDK.

Événements

L'intégration côté client pour PlayerGameEvent est la suivante :

Créer un événement de jeu de joueur

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

Créer un événement de jeu de joueur 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 ...

Enregistrer l'événement et l'importer

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