Android 게임의 게임 통계

이 가이드에서는 Android 애플리케이션에서 게임 통계 API를 사용하여 게임에서 게임 통계를 달성하고 표시하는 방법을 보여줍니다. API는 com.google.android.gms.games 및 com.google.android.gms.games.playergameevent 패키지에서 찾을 수 있습니다.

시작하기 전에

아직 검토하지 않았다면 게임 통계 게임 개념을 검토하는 것이 좋습니다.

게임 통계 API를 사용하여 코딩을 시작하기 전에 다음을 진행합니다.

게임 통계 클라이언트 가져오기

게임 통계 API를 사용하려면 먼저 게임에 GameStatsClient 객체를 확보해야 합니다. 이렇게 하려면 Games.getGameStatsClient() 메서드를 호출하고 활동을 전달하면 됩니다.

클라이언트 측 통합

PlayerGameEvent의 클라이언트 측 통합에는 트리거 지점에서 Java SDK로 이벤트 객체를 빌드하고 SDK에서 제공하는 업로드 함수를 사용하여 전송하는 작업이 포함됩니다.

마찬가지로 progressUpdate 이벤트의 경우 추가로 정의된 속성이 있는 currentProgress 속성을 사용하여 업데이트된 진행률을 기록하고 SDK에서 제공하는 업로드 함수를 사용하여 전송합니다.

이벤트

PlayerGameEvent의 클라이언트 측 통합은 다음과 같습니다.

플레이어 게임 이벤트 빌드

자바


// 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 플레이어 게임 이벤트 빌드

자바


// Build the PlayerGameEvent
PlayerGameEvent event = new PlayerGameEvent.Builder("progressUpdate")
  .addProperty("currentProgress", 52)
  // Add other properties if needed
  .build();

List events = new ArrayList<>();
// ... populate list ...

이벤트 기록 및 업로드

자바


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

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

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