欢迎使用 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 中下载并设置示例应用,请执行以下操作:
- 从 示例下载页面。
- 导入
android-basic-samples
项目。此项目包含“TypeANumber
”和其他 Android 游戏 示例。如需在 Android Studio 中执行此操作,请执行以下操作: <ph type="x-smartling-placeholder">- </ph>
- 点击文件 >导入项目。
- 找到您在开发环境中下载
android-basic-samples
的目录 虚拟机。选择文件android-basic-samples/build.gradle
,然后点击 OK。
- 在
TypeANumber
模块中,打开AndroidManifest.xml
并将软件包名称从com.google.example.games.tanc
替换为您自己的其他软件包名称。新的软件包名称必须 不能以com.google
、com.example
或com.android
开头。
第 2 步:在 Google Play 管理中心内设置游戏
您可以在 Google Play 管理中心管理游戏的 Google Play 游戏服务; 配置用于对游戏进行授权和身份验证的元数据。
如需在 Google Play 管理中心内设置示例游戏,请执行以下操作:
- 将您的网络浏览器指向 Google Play 管理中心和 登录。如果您之前没有在 Google Play 管理中心注册过,系统会提示您进行注册。
- 请按照以下说明操作:
将您的游戏添加到 Google Play 管理中心。
- 当系统询问您是否在应用中使用 Google API 时,选择我尚未在自己的游戏中使用任何 Google API。
- 在本开发者指南中,您可以在表单中填写自己的信息 游戏详情为方便起见,您可以使用占位符图标和屏幕截图 (位于下载页面)。
- 请按照以下说明操作:
生成 OAuth 2.0 客户端 ID
。
<ph type="x-smartling-placeholder">
- </ph>
- 关联 Android 应用时,请确保指定确切的软件包 名称。
- 您可以使用 Android Studio 中的 Generate Signed APK Wizard 来 生成一个新的密钥库和签名证书(如果您还没有的话)。要了解如何 运行“Generate Signed APK Wizard”,请参阅 在 Android Studio 中为应用签名。
- 请务必记录以下信息以供日后使用:
<ph type="x-smartling-placeholder">
- </ph>
- 您的应用 ID:这是一个字符串 只能包含数字(通常为 12 位或更多),位于客户端 ID 的开头。
- 您的签名证书:请记下您在设置时使用的证书 您的 API 访问权限(您提供的 SHA1 指纹的证书)。您 在测试或发布您的 应用。
- 为 Type-a-Number Challenge 配置成就:
<ph type="x-smartling-placeholder">
- </ph>
- 在 Google Play 管理中心内选择成就标签页。
- 添加以下示例成就:
名称 说明 特殊说明 角分符号 获得的分数是质数。 无 Humble 请求 0 分。 无 Don't get cocky, Kids 在任一模式下获得 9999 分数。 无 我的天哪! 获得 1337 分。 将此成就设为隐藏成就。 无聊 玩游戏 10 次。 将此成就设为增量成就,需要 10 个步骤才能达成。 真的很无聊 玩游戏 100 次。 将此成就设置为增量成就,需要 100 个步骤才能解锁。 - 记录您获得的每项成就的 ID(由字母和数字组成的长字符串) 创建。
- 配置适合您游戏的成就。如需了解详情, 了解成就背后的概念 以及如何在 Android 应用中实现成就功能。
- 为 Type-a-Number Challenge 配置排行榜:
<ph type="x-smartling-placeholder">
- </ph>
- 在 Google Play 管理中心内选择排行榜标签页。
- 添加两个示例排行榜:一个名为“轻松高分”,另一个名为 将其命名为“高难度得分”。两个排行榜都应使用整数得分格式 不含小数位,排序类型采用越大越好。
- 记录您创建的每个排行榜的 ID(一长串字母数字)。
- 配置适合您游戏的排行榜。如需了解详情, 了解排行榜背后的概念和 如何在 Android 中实现排行榜。
- 为您的游戏添加测试账号。 只有尚未在 Google Play 上架的应用才需要执行此步骤 Google Play 管理中心。在应用发布之前,仅所列测试账号 都能登录不过,应用发布后 允许所有人登录。
第 3 步:修改代码
若要运行游戏,您需要将应用 ID 配置为
Android 项目中。您还需要在 AndroidManifest.xml
中添加游戏元数据。
- 打开
res/values/ids.xml
并替换占位符 ID。如果您 如果要从头开始创建 Android 游戏,则需要先创建此文件。- 在
app_id
资源中指定应用 ID。 - 指定您之前在
achievement_*
资源。 - 指定您之前在
leaderboard_*
资源。
- 在
- 打开
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 上
如需在实体测试设备上运行游戏,请执行以下操作:
- 确认您已设置用于登录的测试账号 应用(如第 2 步中所述)。
- 导出 APK,并使用您设置时所用的证书为其签名 在 Google Play 管理中心内完成相应项目。如需在 Android Studio 中导出已签名的 APK,请点击 构建 >Generate Signed APK。
- 使用
adb
工具在您的实际测试设备上安装已签名的 APK。 要了解如何安装应用,请参阅 在设备上运行您的应用。