Android 版 Play 游戏服务入门

随着 Google 登录 API 的弃用,我们将在 2026 年移除 games v1 SDK。2025 年 2 月之后,您将无法在 Google Play 上发布新集成 games v1 SDK 的游戏。建议您改用 games v2 SDK。
虽然使用之前 games v1 集成的现有游戏仍可继续运行几年,但建议您从 2025 年 6 月开始迁移到 v2
本指南适用于 Play 游戏服务 v1 SDK。如需了解最新 SDK 版本的信息,请参阅 v2 文档

欢迎使用 Google Play 游戏服务进行 Android 游戏开发!

Play 游戏 SDK 提供了跨平台的 Google Play 游戏服务,可让您轻松地将成就、排行榜和保存的游戏等热门游戏功能集成到您的平板电脑和手机游戏中。

本次培训将指导您安装一个适用于 Android 的示例游戏应用,并快速开始创建您自己的 Android 游戏。《Type-a-Number Challenge》示例应用演示了如何将成就和排行榜集成到您的游戏中。

准备工作

要准备您的应用,请完成以下各部分中的步骤。

应用前提条件

确保您的应用构建文件使用以下值

  • 一个 minSdkVersion 大于或等于 19
  • 一个 compileSdkVersion 大于或等于 28

在 Google Play 管理中心设置您的游戏

Google Play 管理中心是管理游戏的 Google Play 游戏服务以及配置授权和验证游戏的元数据的位置。如需了解详情,请参阅设置 Google Play 游戏服务

配置您的应用

在项目级 build.gradle 文件中,在 buildscriptallprojects 部分包含 Google 的 Maven 代码库Maven Central 代码库

  buildscript {
    repositories {
      google()
      mavenCentral()
    }
  }

  allprojects {
    repositories {
      google()
      mavenCentral()
    }
  }

将 Play Games SDK 的 Google Play 服务依赖项添加到您的模块级 Gradle 构建文件(通常为 app/build.gradle)中

  dependencies {
    implementation 'com.google.android.gms:play-services-games:23.2.0'
  }

示例应用指南

本次培训将指导您安装一个适用于 Android 的示例游戏应用,并快速开始创建您自己的 Android 游戏。《Type-a-Number Challenge》示例应用演示了如何将成就和排行榜集成到您的游戏中。

第 1 步:下载示例应用

对于本开发者指南,您需要下载《Type-a-Number Challenge》Android 示例应用。

如要在 Android Studio 中下载并设置示例应用

  1. 示例下载页面下载 Android 示例。
  2. 导入 android-basic-samples 项目。此项目包含 TypeANumber 和其他 Android 游戏示例。如要在 Android Studio 中执行此操作
    1. 点击 文件 > 导入项目
    2. 浏览到您在开发机器上下载 android-basic-samples 的目录。选择文件 android-basic-samples/build.gradle,然后点击确定
  3. TypeANumber 模块中,打开 AndroidManifest.xml 并将软件包名称从 com.google.example.games.tanc 更改为您自己的不同软件包名称。新的软件包名称不得以 com.googlecom.examplecom.android 开头。

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

Google Play 管理中心是管理游戏的 Google Play 游戏服务以及配置授权和验证游戏的元数据的位置。

如要在 Google Play 管理中心设置示例游戏

  1. 在网络浏览器中访问 Google Play 管理中心并登录。如果您之前未注册过 Google Play 管理中心,系统会提示您进行注册。
  2. 按照这些说明将您的游戏添加到 Google Play 管理中心
    1. 当被问及是否在应用中使用 Google API 时,选择我还没有在游戏中使用任何 Google API
    2. 出于本开发者指南的目的,您可以使用自己的游戏详情填写表格。为了方便起见,您可以使用下载页面提供的占位符图标和屏幕截图。
  3. 按照这些说明为您的 Android 应用生成 OAuth 2.0 客户端 ID
    1. 关联 Android 应用时,请务必指定您之前重命名示例软件包时使用的确切软件包名称。
    2. 如果您还没有新的密钥库和签名证书,可以在 Android Studio 中使用“生成签名 APK 向导”来生成。要了解如何运行“生成签名 APK 向导”,请参阅在 Android Studio 中为您的应用签名
  4. 务必记录以下信息,以备将来使用
    1. 您的应用 ID:这是一串仅包含数字(通常为 12 个或更多)的字符串,位于您的客户端 ID 的开头。
    2. 您的签名证书:记下您在设置 API 访问权限时使用的证书(即您提供了 SHA1 指纹的证书)。在测试或发布应用时,您应该使用同一证书为应用签名。
  5. 为《Type-a-Number Challenge》配置成就
    1. 在 Google Play 管理中心选择成就标签页。
    2. 添加以下示例成就
      名称 说明 特别说明
      Prime 获得一个质数分数。
      Humble 请求获得 0 分。
      Don't get cocky, kid 在任一模式下请求获得 9999 分。
      OMG U R TEH UBER LEET! 获得 1337 分。 将其设为隐藏成就。
      Bored 玩该游戏 10 次。 将其设为一项增量成就,需要 10 步才能解锁。
      Really Really Bored 玩该游戏 100 次。 将其设为一项增量成就,需要 100 步才能解锁。
    3. 记下您创建的每项成就的 ID(长字母数字字符串)。
    4. 配置适合您游戏的成就。如需了解详情,请参阅成就的概念如何在 Android 中实现成就
  6. 为《Type-a-Number Challenge》配置排行榜
    1. 在 Google Play 管理中心选择排行榜标签页。
    2. 添加两个示例排行榜:“Easy High Scores”和“Hard High Scores”。这两个排行榜都应使用整数分数格式,小数点位数为 0,排序类型为越大越好
    3. 记下您创建的每个排行榜的 ID(长字母数字字符串)。
    4. 配置适合您游戏的排行榜。如需了解详情,请参阅排行榜的概念如何在 Android 中实现排行榜
  7. 为您的游戏添加测试帐号。此步骤仅适用于尚未在 Google Play 管理中心发布的应用程序。应用发布之前,只有 Google Play 管理中心中列出的测试帐号才能登录。但是,应用发布后,所有人都可以登录。

第 3 步:修改您的代码

要运行游戏,您需要将应用 ID 配置为 Android 项目中的一项资源。您还需要在 AndroidManifest.xml 中添加游戏元数据。

  1. 打开 res/values/ids.xml 并替换占位符 ID。如果您正在从头开始创建 Android 游戏,则需要先创建此文件。
    1. app_id 资源中指定您的应用 ID。
    2. 在相应的 achievement_* 资源中指定您之前创建的每项成就的 ID。
    3. 在相应的 leaderboard_* 资源中指定您之前创建的每个排行榜的 ID。
  2. 打开 AndroidManifest.xml,并在 <manifest> 元素的 package 属性中输入您的软件包名称。如果您正在从头开始创建 Android 游戏,请务必在 <application> 元素中添加以下代码
    <meta-data android:name="com.google.android.gms.games.APP_ID"
        android:value="@string/app_id" />
    <meta-data android:name="com.google.android.gms.version"
       android:value="@integer/google_play_services_version"/>
    

第 4 步:测试您的游戏

为确保 Google Play 游戏服务在您的游戏中正常运行,请在将应用发布到 Google Play 之前对其进行测试。

如要在您的物理测试设备上运行游戏

  1. 验证您是否已按照第 2 步中的说明设置了用于登录应用的测试帐号。
  2. 导出 APK 并使用您在 Google Play 管理中心设置项目时使用的同一证书对其进行签名。要在 Android Studio 中导出已签名的 APK,请依次点击 Build > Generate Signed APK
  3. 使用 adb 工具在您的物理测试设备上安装已签名的 APK。要了解如何安装应用,请参阅在设备上运行