开始使用 Play 游戏服务

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

Play 游戏 SDK 提供跨平台的 Google Play 游戏服务，让您可以轻松地在平板电脑和移动游戏中集成热门游戏功能，例如成就、排行榜和已保存的游戏。

本培训将指导您安装适用于 Android 的示例游戏应用，并快速开始创建自己的 Android 游戏。“输入数字挑战”示例应用演示了如何在游戏中集成成就和排行榜。

开始之前

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

应用先决条件

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

不低于 19 的 minSdkVersion
不低于 28 的 compileSdkVersion

在 Google Play Console 中设置游戏

Google Play Console 是您管理游戏 Google Play 游戏服务以及配置授权和身份验证元数据的地方。有关更多信息，请参阅设置 Google Play 游戏服务。

配置您的应用

在项目级别的 build.gradle 文件中，在 buildscript 和 allprojects 部分中包含 Google 的 Maven 存储库和 Maven 中心存储库

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

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

将 Play 游戏 SDK 的 Google Play 服务依赖项添加到您的模块的 Gradle 构建文件中，该文件通常为 app/build.gradle

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

示例应用指南

步骤 1：下载示例应用

对于本开发者指南，您需要下载“输入数字挑战”示例 Android 应用。

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

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

步骤 2：在 Google Play Console 中设置游戏

Google Play Console 是您管理游戏 Google Play 游戏服务以及配置授权和身份验证元数据的地方。

在 Google Play Console 中设置示例游戏

将您的网络浏览器指向 Google Play Console 并登录。如果您之前未注册过 Google Play Console，系统会提示您注册。
按照以下说明将游戏添加到 Google Play Console。
1. 当询问您是否在应用中使用 Google API 时，请选择我尚未在我的游戏中使用任何 Google API。
2. 出于本开发者指南的目的，您可以使用您自己的游戏详细信息填写表单。为了方便起见，您可以使用下载页面中提供的占位符图标和屏幕截图。
按照以下说明为您的 Android 应用生成 OAuth 2.0 客户端 ID。
1. 链接 Android 应用时，请确保指定您之前重命名示例包时使用的确切包名称。
2. 如果您还没有密钥库和签名证书，则可以使用 Android Studio 中的生成签名 APK 向导生成新的密钥库和签名证书。要了解如何运行生成签名 APK 向导，请参阅在 Android Studio 中签名您的应用。
确保记录以下信息以备后用
1. 您的应用 ID：仅包含数字（通常为 12 位或更多）的字符串，位于客户端 ID 的开头。
2. 您的签名证书：记下您在设置 API 访问权限时使用的证书（您提供的 SHA1 指纹的证书）。您应该使用相同的证书在测试或发布应用时对应用进行签名。

为“输入数字挑战”配置成就

在 Google Play Console 中选择成就选项卡。

添加以下示例成就

名称	描述	特殊说明
质数	获得一个质数分数。	无
谦逊	请求获得 0 分。	无
别得意忘形，小子	在任何模式下请求获得 9999 分。	无
我的天啊，你太厉害了！	获得 1337 分。	将此设置为隐藏成就。
无聊	玩游戏 10 次。	将此设置为一个递增成就，解锁需要 10 个步骤。
非常无聊	玩游戏 100 次。	将此设置为一个递增成就，解锁需要 100 个步骤。

记录您创建的每个成就的 ID（长字母数字字符串）。
配置适合您游戏的成就。要了解更多信息，请参阅成就背后的概念和如何在 Android 中实现成就。

配置“猜数字挑战”的排行榜
1. 在 Google Play Console 中选择“排行榜”选项卡。
2. 添加两个示例排行榜：“简单模式高分”和“困难模式高分”。这两个排行榜都应使用整数分数格式，小数位数为 0，排序类型为“越大越好”。
3. 记录您创建的每个排行榜的 ID（长字母数字字符串）。
4. 配置适合您游戏的排行榜。要了解更多信息，请参阅排行榜背后的概念和如何在 Android 中实现排行榜。
为您的游戏添加测试账号。此步骤仅适用于尚未在 Google Play Console 中发布的应用。在应用发布之前，只有 Google Play Console 中列出的测试账号才能登录。但是，应用发布后，每个人都可以登录。

步骤 3：修改您的代码

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

打开res/values/ids.xml并替换占位符 ID。如果您是从头开始创建 Android 游戏，则需要先创建此文件。
1. 在app_id资源中指定您的应用 ID。
2. 在相应的achievement_*资源中指定您之前创建的每个成就 ID。
3. 在相应的leaderboard_*资源中指定您之前创建的每个排行榜 ID。

打开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 之前对其进行测试。

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

验证您是否已设置用于登录应用的测试账号（如步骤 2 中所述）。
导出 APK 并使用与在 Google Play Console 中设置项目时使用的相同证书对其进行签名。要在 Android Studio 中导出已签名的 APK，请点击“构建”>“生成已签名的 APK”。
使用adb工具将已签名的 APK 安装到您的物理测试设备上。要了解如何安装应用，请参阅在设备上运行。