为游戏添加活动

本指南介绍了如何在 C++ 应用中使用事件服务。

准备工作

建议您查看 活动游戏概念

如需设置 C++ 开发环境以使用事件服务,请按照 C++ 使用入门指南。您可以下载 从 SDK 下载页面获取 Play 游戏服务 C++ SDK。

您必须先在 Google Play 管理中心

提交活动

您可以在游戏中添加代码,以便在发生与您游戏相关的事件时发送通知给 Events 服务。您可以在游戏中捕获的事件示例包括:杀死敌人、探索或返回各种游戏区域,或获取游戏内物品。通常,您应在 事件管理器中的 Increment 方法,以便在用户每次游戏时将事件计数加 1 执行与该事件相关的操作 (例如“杀了一只怪物”)。

以下示例展示了如何将更新后的事件数提交到 Events 服务。

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

检索事件

如需检索 Google 服务器中存储的特定事件的当前计数值,请调用 Fetch* 方法之一。例如,如果您想在游戏的自定义界面中显示玩家的游戏内统计信息或进度,就可以这样做。

以下示例展示了如何在 Google Cloud 控制台中检索和记录事件数据: 您的游戏。

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