Statistik Game untuk game Android

Panduan ini menunjukkan cara menggunakan Game Stats API di aplikasi Android untuk membuka kunci dan menampilkan Statistik Game dalam game Anda. API ini dapat ditemukan dalam paket com.google.android.gms.games dan com.google.android.gms.games.playergameevent.

Sebelum memulai

Jika Anda belum melakukannya, sebaiknya tinjau konsep Statistik Game.

Sebelum Anda mulai membuat kode menggunakan Game Stats API:

Mendapatkan klien Statistik Game

Untuk mulai menggunakan Game Stats API, game Anda harus telah terlebih dahulu mendapatkan GameStatsClient objek. Anda dapat melakukannya dengan memanggil Games.getGameStatsClient() metode dan meneruskan aktivitas.

Integrasi sisi klien

Integrasi sisi klien untuk PlayerGameEvent akan melibatkan Anda dalam membuat objek peristiwa di Java SDK, di titik pemicu dan mengirimkannya menggunakan fungsi upload yang disediakan oleh SDK.

Demikian pula, untuk peristiwa progressUpdate, catat progres yang diperbarui menggunakan properti currentProgress dengan properti tambahan yang ditentukan dan kirimkan menggunakan fungsi upload yang disediakan oleh SDK.

Acara

Integrasi sisi klien untuk PlayerGameEvent adalah:

Membuat Peristiwa Game Pemain

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

Membuat Peristiwa Game Pemain 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 ...

Merekam Peristiwa dan Mengupload

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