Android 版 Play 游戏服务使用入门

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

Play Games SDK 提供跨平台 Google Play 游戏服务，让你可以 集成了热门游戏功能，例如成就、排行榜和 平板电脑和手机游戏中的游戏存档。

本培训将指导您安装一款适用于 Android 的示例游戏应用 并快速着手打造自己的 Android 游戏。数字输入 挑战示例应用演示了如何集成成就和 排行榜。

准备工作

为了让您的应用做好准备，请完成以下部分中的步骤。

应用要满足的前提条件

确保您应用的 build 文件使用以下值：

  • minSdkVersion 为 19 或更高版本
  • compileSdkVersion 为 28 或更高版本

在 Google Play 管理中心内设置游戏

您可以在 Google Play 管理中心内管理游戏的 Google Play 游戏服务，以及配置用于对游戏进行授权和身份验证的元数据。如需了解详情，请参阅设置 Google Play 游戏服务。

配置您的应用

在项目级 build.gradle 文件中，添加 Google 的 Maven 制品库 和 Maven 中央代码库 在 buildscript 和 allprojects 两个部分中执行以下操作：

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

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

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

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

示例应用指南

本培训将指导您安装 Android 版示例游戏应用 并快速着手打造自己的 Android 游戏。数字输入 挑战示例应用演示了如何集成成就和 排行榜。

第 1 步：下载示例应用

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

如需在 Android Studio 中下载并设置示例应用，请执行以下操作：

  1. 从 示例下载页面。
  2. 导入 android-basic-samples 项目。此项目包含“TypeANumber”和其他 Android 游戏 示例。如需在 Android Studio 中执行此操作，请执行以下操作：
    1. 点击文件 >导入项目。
    2. 找到您在开发环境中下载 android-basic-samples 的目录 虚拟机。选择文件 android-basic-samples/build.gradle，然后点击 OK。
  3. 在 TypeANumber 模块中，打开 AndroidManifest.xml 并将软件包名称从 com.google.example.games.tanc 替换为您自己的其他软件包名称。新的软件包名称必须 不能以 com.google、com.example 或 com.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. 请按照以下说明操作： 生成 OAuth 2.0 客户端 ID 。
    1. 关联 Android 应用时，请确保指定确切的软件包 名称。
    2. 您可以使用 Android Studio 中的 Generate Signed APK Wizard 来 生成一个新的密钥库和签名证书（如果您还没有的话）。要了解如何 运行“Generate Signed APK Wizard”，请参阅 在 Android Studio 中为应用签名。
  4. 请务必记录以下信息以供日后使用：
    1. 您的应用 ID：这是一个字符串 只能包含数字（通常为 12 位或更多），位于客户端 ID 的开头。
    2. 您的签名证书：请记下您在设置时使用的证书 您的 API 访问权限（您提供的 SHA1 指纹的证书）。您 在测试或发布您的 应用。
  5. 为 Type-a-Number Challenge 配置成就：
    1. 在 Google Play 管理中心内选择成就标签页。
    2. 添加以下示例成就：
      名称 说明 特殊说明
      角分符号 获得的分数是质数。 无
      Humble 请求 0 分。 无
      Don't get cocky, Kids 在任一模式下获得 9999 分数。 无
      我的天哪！ 获得 1337 分。 将此成就设为隐藏成就。
      无聊 玩游戏 10 次。 将此成就设为增量成就，需要 10 个步骤才能达成。
      真的很无聊 玩游戏 100 次。 将此成就设置为增量成就，需要 100 个步骤才能解锁。
    3. 记录您获得的每项成就的 ID（由字母和数字组成的长字符串） 创建。
    4. 配置适合您游戏的成就。如需了解详情， 了解成就背后的概念 以及如何在 Android 应用中实现成就功能。
  6. 为 Type-a-Number Challenge 配置排行榜：
    1. 在 Google Play 管理中心内选择排行榜标签页。
    2. 添加两个示例排行榜：一个名为“轻松高分”，另一个名为 将其命名为“高难度得分”。两个排行榜都应使用整数得分格式 不含小数位，排序类型采用越大越好。
    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_* 资源。
    3. 指定您之前在 leaderboard_* 资源。
  2. 打开 AndroidManifest.xml，然后在 package 中输入您的软件包名称。 <manifest> 的属性元素。如果您是通过 Android Studio 请确保同样在 <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，请点击 构建 >Generate Signed APK。
  3. 使用 adb 工具在您的实际测试设备上安装已签名的 APK。 要了解如何安装应用，请参阅 在设备上运行您的应用。
。