경기 통계

이 문서에서는 C++ 게임에서 Google Play 게임즈 서비스 게임 통계를 사용하는 방법을 설명합니다. 이 문서에서는 Google Play 게임즈 서비스 설정에 설명된 대로 프로젝트를 설정했다고 가정합니다. 게임 통계 API는 PgsGameStatsClient에서 찾을 수 있습니다.

시작하기 전에

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

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

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

업적 API를 사용하려면 먼저 게임에 PgsGameStatsClient 객체를 확보해야 합니다. 이렇게 하려면 PgsPlayerGameEvent_create 메서드를 호출하고 활동을 전달하면 됩니다.

클라이언트 측 통합

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

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

이벤트

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

플레이어 게임 이벤트 빌드

C++


// Build the PlayerGameEvent
PgsPlayerGameEvent* player_event = PgsPlayerGameEvent_create("matchCompleted");
if (player_event != nullptr) {
   PgsPlayerGameEvent_putString(player_event, "matchId", "Match_A");
   PgsPlayerGameEvent_putString(player_event, "gameMode", "Battle_B");
   PgsPlayerGameEvent_putString(player_event, "mapId", "Location_XYZ");
   PgsPlayerGameEvent_putBoolean(player_event, "isWinner", true);
   PgsPlayerGameEvent_putLong(player_event, "playerElimination", 2);
}
progressUpdate 플레이어 게임 이벤트 빌드

C++


PgsPlayerGameEvent* progress_event = PgsPlayerGameEvent_create("progressUpdate");
if (progress_event != nullptr) {
   PgsPlayerGameEvent_putLong(progress_event, "currentProgress", 52);
}
이벤트 기록 및 업로드

C++


// Record the event
PgsGameStatsClient_recordEvent(client, player_event);

// This submits the events to PGS
PgsGameStatsClient_requestEventsUpload(client);

// Clean up handle to avoid leaks
PgsPlayerGameEvent_destroy(player_event);

// Clean up client handle when PGS operations are finished
PgsGameStatsClient_destroy(client);