สถิติเกมสำหรับเกม Android

คู่มือนี้จะแสดงวิธีใช้ Game Stats API ในแอปพลิเคชัน Android เพื่อปลดล็อกและแสดงสถิติเกมในเกม คุณจะพบ API ได้ ในแพ็กเกจ com.google.android.gms.games และ com.google.android.gms.games.playergameevent

ก่อนเริ่มต้น

หากยังไม่ได้ดำเนินการ คุณอาจพบว่าการอ่านแนวคิดเกี่ยวกับ สถิติเกมมีประโยชน์

ก่อนเริ่มเขียนโค้ดโดยใช้ Game Stats API ให้ทำดังนี้

รับไคลเอ็นต์สถิติเกม

หากต้องการเริ่มใช้ Game Stats API เกมของคุณต้องได้รับ GameStatsClient ออบเจ็กต์ก่อน คุณทำได้โดยการเรียกใช้ Games.getGameStatsClient() เมธอดและส่งกิจกรรม

การผสานรวมฝั่งไคลเอ็นต์

การผสานรวมฝั่งไคลเอ็นต์สำหรับ PlayerGameEvent จะเกี่ยวข้องกับการที่คุณ สร้างออบเจ็กต์เหตุการณ์ใน Java SDK ที่จุดทริกเกอร์และส่งออบเจ็กต์ดังกล่าว โดยใช้ฟังก์ชันการอัปโหลดที่ SDK มีให้

ในทำนองเดียวกัน สำหรับเหตุการณ์ progressUpdate ให้บันทึกความคืบหน้าที่อัปเดตโดยใช้พร็อพเพอร์ตี้ currentProgress พร้อมพร็อพเพอร์ตี้เพิ่มเติมที่กำหนดไว้ และส่งพร็อพเพอร์ตี้เหล่านั้นโดยใช้ฟังก์ชันการอัปโหลดที่ SDK มีให้

กิจกรรม

การผสานรวมฝั่งไคลเอ็นต์สำหรับ PlayerGameEvent มีดังนี้

สร้างเหตุการณ์เกมของผู้เล่น

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

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

บันทึกและอัปโหลดเหตุการณ์

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