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 のクライアントサイドの統合は次のとおりです。

プレーヤー ゲーム イベントをビルドする

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