ゲームへのイベントの追加

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

始める前に

イベントゲームのコンセプトをまだ確認されていない場合は、確認することをおすすめします。

Events サービスを使用するように C++ 開発環境を設定するには、C++ スタートガイドの手順に沿って操作します。Play Games 開発者サービス C++ SDK は、SDK のダウンロード ページからダウンロードできます。

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

イベントを送信する

コードをゲームに追加して、ゲームに関連するイベントが発生したときにイベント サービスに通知することができます。ゲームでキャプチャできるイベントの例としては、敵を倒す、さまざまなゲーム領域を探索する、ゲーム内アイテムを獲得するなどがあります。通常は、イベント マネージャーで Increment メソッドを呼び出して、プレイヤーがイベントに関連付けられたアクション（「1 匹のモンスターを倒した」など）を実行するたびに、イベントのカウントを 1 増やします。

次の例は、更新されたイベント数を Events サービスに送信する方法を示しています。

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

イベントを取得する

特定のイベントについて Google のサーバーに保存されている現在のカウント値を取得するには、Fetch* メソッドのいずれかを呼び出します。たとえば、ゲーム内のカスタム UI からプレーヤーのゲーム内統計情報や進行状況を表示する場合などに、この方法を使用します。

次の例は、ゲームでイベントデータを取得してロギングする方法を示しています。

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