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:

• Ikuti petunjuk penginstalan dan penyiapan aplikasi untuk menggunakan Layanan Google Play Games di panduan Menyiapkan SDK layanan Google Play.

• Tentukan Statistik Game yang ingin Anda buka atau tampilkan pada game dengan mengikuti petunjuk di Panduan Konsol Google Play.

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

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

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

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

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

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