ゲームにイベントを追加する

このガイドでは、C++ アプリケーションでイベント サービスを使用する方法について説明します。

始める前に

まだ読んでいない場合は、 イベントゲームのコンセプトをご覧ください。

イベント サービスを使用するように C++ 開発環境をセットアップするには、 C++ スタートガイドをご覧ください。次のアプリをダウンロードできます。 SDK のダウンロード ページから Play Games サービスの C++ SDK をダウンロードします。

ゲームからイベントにアクセスするには、まずイベントを定義する必要があります。 Google Play Console

イベントを送信する

イベントの発生時にイベント サービスに通知するコードをゲームに追加できます。 向上します測定可能なイベントの例としては、 敵を倒す、探索する、さまざまなゲームに戻る、 ゲーム内アイテムの取得などの操作を行えます。通常は プレーヤーが操作されるたびにイベントのカウントを 1 ずつ増分する、イベント マネージャーの Increment メソッド ユーザーがイベントに関連付けられたアクションを実行 (「1 匹のモンスターを殺した」など)。

次の例は、更新されたイベント数を Google Cloud の 見てみましょう。

  // Increment the event count when player performs the 'Attack blue
  // monster' action.
  game_services_->Events().Increment(BLUE_MONSTER_EVENT_ID);

イベントの取得

特定の期間に Google のサーバーに保存されている現在のカウント値を取得するには、 Fetch* メソッドの 1 つを呼び出します。おすすめ たとえば、プレーヤーのゲーム内統計情報を表示する場合や、 ゲームのカスタム UI で表示できます。

次の例は、BigQuery でイベントデータを取得して記録する方法を示しています。 説明します。

  // Log Events details.
  LogI("---- Showing Event Counts -----");
  gpg::EventManager::FetchAllCallback callback =
      [](gpg::EventManager::FetchAllResponse const &response) {
    for (auto i : response.data) {
      gpg::Event const &event = i.second;
      LogI("Event name: %s  count: %d", event.Name().c_str(),
           event.Count());
    }
  };
  game_services_->Events().FetchAll(callback);