Số liệu thống kê trò chơi cho trò chơi Android

Tài liệu này sẽ hướng dẫn bạn cách sử dụng API số liệu thống kê trò chơi trong một ứng dụng Android để mở khoá và hiển thị số liệu thống kê trò chơi trong trò chơi của bạn. Bạn có thể tìm thấy các API trong các gói com.google.android.gms.games và com.google.android.gms.games.playergameevent.

Trước khi bắt đầu

Nếu chưa từng có kinh nghiệm, bạn có thể xem lại các khái niệm về số liệu thống kê trò chơi.

Trước khi bắt đầu lập trình bằng Game Stats API:

Tải ứng dụng Số liệu thống kê trò chơi

Để bắt đầu sử dụng API số liệu thống kê trò chơi, trước tiên, trò chơi của bạn phải có được một đối tượng GameStatsClient. Bạn có thể thực hiện việc này bằng cách gọi phương thức Games.getGameStatsClient() và truyền vào hoạt động.

Tích hợp phía ứng dụng

Hoạt động tích hợp phía máy khách cho PlayerGameEvent sẽ liên quan đến việc bạn tạo đối tượng sự kiện trong SDK Java, tại các điểm kích hoạt và gửi các đối tượng đó bằng cách sử dụng các hàm tải lên do SDK cung cấp.

Tương tự, đối với sự kiện progressUpdate, hãy ghi lại tiến trình đã cập nhật bằng cách sử dụng thuộc tính currentProgress cùng với các thuộc tính được xác định bổ sung và gửi các thuộc tính đó bằng cách sử dụng các hàm tải lên do SDK cung cấp.

Sự kiện

Các ứng dụng tích hợp phía ứng dụng cho PlayerGameEvent là:

Tạo sự kiện trong trò chơi của người chơi

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

Tạo progressUpdate Sự kiện trong trò chơi của người chơi

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

Ghi lại sự kiện và tải lên

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