适用于 C++ 的 Play 游戏服务使用入门 (Android)

在 Google 登录 API 弃用后，我们将于 2026 年移除 Play 游戏服务 v1 SDK。自 2025 年 2 月起，您将无法在 Google Play 上发布新集成了 Games v1 SDK 的游戏。我们建议您改用游戏 v2 SDK。
虽然集成旧版游戏 v1 的现有游戏在未来几年内仍可正常运行，但我们建议您从 2025 年 6 月开始迁移到 v2。
本指南适用于 Play 游戏服务 v1 SDK。适用于 Play 游戏服务 v2 的 C++ SDK 尚未推出。

本开发者指南将介绍如何在 Android 上编译和运行使用 Google Play 游戏服务 API 的 C++ 游戏。在开始之前，请下载并配置以下要求：

本开发者指南使用的是 Android 原生开发套件 (NDK)。如果您不熟悉 NDK，请先参阅 NDK 文档和示例，然后再继续。

第 1 步：设置环境

  1. 下载 Android SDK 和 Android NDK，然后将其解压缩到您的机器上。在您的环境中，将 SDK_ROOT 设置为 Android SDK 文件夹的位置，并将 NDK_ROOT 设置为 Android NDK 文件夹的位置。
  2. 下载 C++ 示例游戏。本开发者指南将您机器上示例的位置称为 SAMPLES_DIR。
  3. 下载 Google Play 游戏服务 C++ SDK。将 SDK 解压缩到开发机器上。在您的环境中，将变量 NDK_MODULE_PATH 设置为指向 gpg-cpp-sdk 目录上方的目录。您应该具有以下目录结构： 
    NDK_MODULE_PATH/
gpg-cpp-sdk/
  4. 打开 Eclipse。如果您尚未这样做，请告知 Eclipse NDK 的安装位置，方法是依次点击 Preferences > Android > NDK。

  5. 将 Google Play 服务库项目导入到您的 Eclipse 工作区。

    1. 在 Eclipse 中，依次点击 File > Import > Android > Existing Android Code into Workspace。
    2. 选择 SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib，其中 SDK_ROOT 是 Android SDK 的位置。
    3. 点击 Finish。

  6. 将极简示例项目导入到您的 Eclipse 工作区。

    1. 在 Eclipse 中，依次点击 File > Import > Android > Existing Android Code into Workspace。
    2. 选择 SAMPLES_DIR/samples-android/minimalist。
    3. 点击 Finish。

  7. 右键点击 MinimalistActivity 项目，然后点击属性。在 Android 下，向下滚动到 Library 部分，并确保已正确引用 google-play-services_lib 项目。如果不是，请移除相应参考，然后从工作区中重新添加。

Eclipse 会自动编译项目的 Java 和 Android 源代码；不过，jni 文件夹中的原生代码需要单独编译。如需手动执行此操作，请前往 jni 文件夹并运行 ndk-build。请务必在 jni 文件夹中进行任何更改后执行此操作。

您的项目现在应该可以编译了，但还无法正常运行。您必须先在 Google Play 管理中心内配置游戏。

第 2 步：在 Google Play 管理中心内设置游戏

在 Google Play 管理中心为您的游戏创建一个条目。此操作会为您的应用启用游戏服务，并创建 OAuth 2.0 客户端 ID（如果您尚无该 ID）。

  1. 按照设置 Google Play 游戏服务中所述的步骤为您的游戏创建一个条目。
  2. 在 AndroidManifest.xml 中，将 <manifest> 标记的 package 属性更改为您在设置 Google Play 管理中心时选择的软件包名称。进行此更改后，您可能需要修复整个项目中的一些引用（尤其是对生成的 R 类的引用）。
  3. 打开 res/values/ids.xml，然后将您的应用 ID 放在此处。请注意，应用 ID 与客户端 ID 不同；应用 ID 是 Google Play 管理中心的游戏详情页面中游戏名称旁边的数字。

第 3 步：运行示例

如需运行该示例，您需要一部已安装 Google Play 服务的实体 Android 设备或模拟器：

  1. 运行 ndk-build 以编译原生代码。
  2. 在 Eclipse 中，依次点击 Run > Run As > Android Application，然后在设备上运行示例。
  3. 打开示例后，点按屏幕上的任意位置。您应该会看到 Google Play Games 徽标。如果您已正确配置应用，系统会提示您登录。

可选：使用 Eclipse 自动构建

以下步骤展示了如何配置 Eclipse，以便在您更改 jni 文件夹中的文件时自动运行 ndk-build。

  1. 右键点击 MinimalistActivity 项目，然后点击属性。在“属性”窗口中，选择构建器窗格。
  2. 点击 New 添加新的构建器，然后选择 Program，再点击 OK。
  3. 在名称字段中，输入“NDK Builder”。
  4. 在 Location 下，点击 Browse File System，然后前往 NDK_ROOT 目录并选择 ndk-build 命令。
  5. 在 Working Directory 下，点击 Browse Workspace，然后选择 MinimalistActivity 项目文件夹。
  6. 点击刷新标签页。确保已选中完成后刷新资源复选框。
  7. 选择特定资源单选按钮，然后点击指定资源。在随即显示的对话框中，选择 MinimalActivity 下的 jni 文件夹。
  8. 点击应用，然后点击确定，以完成构建器的创建。

现在，每次您在 jni 文件夹中修改文件时，Eclipse 都会运行 ndk-build 并将输出打印到 Eclipse 控制台。