在将游戏提交到 Google Play 游戏电脑版进行审核之前,请使用此核对清单确保您的游戏符合所有要求并遵循所有最佳实践。
设置和配置项目
- 下载并导入 SDK:集成适用于您环境的最新 Play 游戏电脑版 SDK。如需了解详情,请参阅 Unity 指南或 C++ 指南。
- 创建应用清单:创建一个
manifest.xml文件,将<PackageName>映射到您已声明所有权的 Play 管理中心软件包。如需了解详情,请参阅清单指南。 - 为可执行文件进行数字签名:使用 Authenticode 数字签名为游戏签名,并妥善保管证书,以便日后进行所有更新。虽然您可以在本地开发期间通过启用开发者模式来跳过此步骤,但您必须使用来自已知证书授权机构的实际生产证书对最终二进制文件进行签名。如需了解详情,请参阅为游戏进行数字签名。
- 设置证书格式并发送证书:在 Play 管理中心内配置证书,与 Google 代表分享证书信息,或在初始配置期间发送电子邮件至 google-play-games-pc@google.com。证书文件必须仅包含与证书相关的信息;请验证是否已移除所有非证书块。您可以使用 OpenSSL 将 DER 或 CER 文件转换为所需的 PEM 格式。
集成 API 和功能
- 初始化 SDK:在启动期间,先实现 SDK 初始化逻辑(例如
InitializeAsync),然后再使用其他功能。如需了解详情,请参阅初始化指南。 - 实现无缝登录:通过 Recall API,使用 Play 游戏客户账号自动对玩家进行身份验证。如需了解详情,请参阅无缝登录指南。
- 集成 Play Integrity:使用
IntegrityClient请求令牌,并在后端验证游戏会话的合法性。如需了解详情,请参阅 Play Integrity 指南。 - 添加 Play Install Referrer:如果您需要跟踪 PC 端的用户获取来源,请集成 Install Referrer API。如需了解详情,请参阅 Install Referrer 指南。
- 处理初始化错误:如需使用 SDK,请调用
GooglePlayInitialize(C++) 或GooglePlayInitialization.InitializeAsync(C#) 来初始化 API。您必须调用此方法,并验证延续回调是否以InitializeResult::ok()(C++) 完成,或Result.IsOk(C#) 是否返回true,然后才能使用任何其他 API。 - 处理强制关停:通过尽快关停客户端进程来处理
kActionRequiredShutdownClientProcess。 - 处理 Google Play 游戏安装要求:处理
kSdkRuntimeUnavailable,告知用户必须安装 Google Play 游戏和 SDK 运行时才能继续。 - 处理 Google Play 游戏更新:通过通知用户需要更新 Google Play 游戏运行时来处理
kSdkRuntimeUpdateRequired。
实现 Play 结算服务
- 检查购买类型:确认您的游戏仅依赖应用内购,因为不支持定期付款和订阅。如需了解详情,请参阅结算常见问题解答。
- 查询商品详情:使用
QueryProductDetails检索本地化的商店数据。如果您有 50 件以上的商品,请将请求拆分为多个调用。如需了解详情,请参阅查询商品指南。 - 启动购买流程:使用
LaunchPurchaseFlow原生处理交易。如果您关闭支付浏览器而未付款,则会出现 5 分钟超时错误。如需了解详情,请参阅购买流程指南。 - 恢复现有购买交易:在启动和前台运行时调用
QueryPurchases,以捕获未确认的跨设备购买交易。如需了解详情,请参阅恢复购买交易指南。 - 安全后端处理:在授予权益并使用
AcknowledgePurchase或ConsumePurchase完成交易之前,请先在后端验证purchaseToken。如需了解详情,请参阅安全处理指南。 - 考虑许可密钥传播延迟:在 Play 管理中心内配置新的结算或许可密钥时,请等待几个小时,让后端缓存在各个商务服务环境中完成同步,然后再进行实时购买测试。在同步完成之前尝试购买会返回错误代码 6。
在开发者模式下测试并执行发布前质量检查
- 在开发者模式下测试:将
<IsDeveloperMode>true</IsDeveloperMode>添加到清单中,并配置抢先体验合作伙伴 GUID,以便进行本地集成开发环境 (IDE) 测试。如需开始新手入门流程,请发送电子邮件至 google-play-games-pc@google.com,获取后续步骤方面的帮助。 - 管理开发者模式购买交易:在开发者模式下测试购买交易时,请在三分钟内消耗购买交易,以防止自动退款。如需了解详情,请参阅测试常见问题解答。
- 移除开发者模式:您必须尽快移除
<IsDeveloperMode>标记,然后再打包发布 build。如需了解详情,请参阅开发者模式指南。 - 使用第三方启动器转发参数:将启动器从 Google Play 游戏客户端收到的所有未知命令行参数直接传递给生成的游戏进程。如需了解详情,请参阅多进程指南。
- 使用 VPN 进行测试:如果您在不受支持的地区进行测试,请使用启用了 TUN 模式的 VPN 来获取受支持的 IP 地址。如需了解详情,请参阅 VPN 测试常见问题解答。
- 支持桌面快捷方式:如需了解如何顺畅地支持快捷方式,请参阅快捷方式常见问题解答,了解快捷方式的执行。使用快捷方式直接启动游戏或第三方启动器可能会导致初始化错误。
封装、测试和发布游戏
- 打包 WAB:使用 Play 发布工具将游戏打包成 Windows App Bundle (WAB)。WAB 文件的大小必须小于 10 GB(对于安装程序发布)和 200 GB(对于 Play 自管式发布)。如需了解详情,请参阅 Play 自管式发布或安装程序发布。
- 使用最新的 SDK 和工具:使用最新版本的 Play 游戏 PC SDK、Play 游戏 PC Unity SDK、Play PC 开发者工具和 Play 发布工具来编译和打包发布版本。
- 确认是否需要提升权限:如果您的安装程序、启动器或卸载程序每次启动时都需要以管理员身份运行,请务必检查您是否已将
INSTALLER_REQUIRES_ELEVATION、LAUNCHER_REQUIRES_ELEVATION或UNINSTALLER_REQUIRES_ELEVATION设置为true。否则,它们将不会以管理员权限运行,从而导致启动失败。如需了解详情,请参阅 WAB 配置文件格式。 - 提交第三方启动器安装程序:如果您使用第三方启动器,请在 WAB 中提交其安装程序。如需了解详情,请参阅安装程序发布指南。
- 处理自动播放会话令牌:如果您通过在
play_publishing_config.xml中设置acceptsCommandLineArguments="true"来启用自动播放,请验证您的安装程序是否会提取--g_session_token=<token>命令行参数并使用该参数启动游戏。确保安装程序能够处理令牌不存在的后备情况。如需了解详情,请参阅启动器常见问题解答。 - 更新游戏和启动器或安装器: Play 自管式发布会自动管理游戏更新。如果您使用安装程序发布,则您的软件包内容(包括启动器安装程序)必须能够自行更新,并管理游戏所需的所有资源,包括更新启动器本身。
- 添加 PC 设备规格:在 Play 管理中心内,依次前往测试和发布 > 高级设置 > 设备规格和平台,然后在 Windows 部分中点击添加 Windows。如果 Windows 选项不可见,您需要先将账号加入许可名单。准备好开始新手入门了吗?请发送电子邮件至 google-play-games-pc@google.com。入驻专家将协助您完成后续步骤。
- 配置 PC 要求:输入 Windows PC 的硬件要求(RAM、GPU、存储空间),并在 Play 管理中心内同意审核政策。如需了解详情,请参阅 PC 要求指南。
- 设置测试访问权限:在 Play 管理中心的 Google Play 游戏电脑版内部测试轨道(测试和发布 > 测试 > 内部测试)中最多配置 100 位测试人员,并上传您的
.wab文件。测试人员必须接受选择加入网页链接,并使用googleplaygames://deeplink/details?id=PACKAGE_NAME安装 build。Windows 不支持封闭式和开放式测试轨道。 - 上传商店资源并提交到正式版轨道:上传 Google Play 游戏电脑版商品详情资源,选择与 Android 目标国家/地区一致或为其子集的目标国家/地区,然后在 Google Play 游戏电脑版正式版轨道(测试和发布 > 正式版)中提交
.wab文件。审核最多需要 7 天。如需了解详情,请参阅正式版发布指南。 - 控制发布时间:在 Play 管理中心的发布概览页面上使用自管式发布功能,控制已获批准的版本何时发布。
- 在预注册期间进行测试:在预注册阶段,您必须在未包含在所选预注册地区中的国家/地区进行内部测试。
- 验证安装程序进程终止:确认主安装程序进程保持活跃状态,直到所有必需的注册表键都已创建并注册。如果该进程过早退出,则安装验证会失败。如需了解详情,请参阅安装程序发布。
- 维护一致的注册表配置单元,并在卸载时进行清理:Google Play 游戏电脑版会在
HKEY_CURRENT_USER之前检查HKEY_LOCAL_MACHINE,并使用第一个匹配的值。在更新和共享启动器游戏之间保持注册表配置单元一致,并在卸载期间移除注册表项,以免过时的HKEY_LOCAL_MACHINE条目遮盖有效的HKEY_CURRENT_USER路径。如需了解详情,请参阅安装程序发布。
从 API 迁移到 SDK
从 API 迁移到 SDK 是一个可选步骤。如果您选择迁移,请遵循以下建议:
- 移除旧版 REST API:将旧版 Play Developer API 调用(例如
purchases.products.get)映射到客户端 Native SDK 函数。如需了解详情,请参阅迁移指南。 - 验证命令行参数:SDK 环境中的命令行参数可能与 API 环境中的命令行参数不同。验证您的软件包是否正确处理和传递所有参数。如需了解详情,请参阅验证。
- 验证注册表路径:为确保顺利迁移到原生 SDK,注册表配置必须与之前的版本保持一致。如需了解详情,请参阅 WAB 文件指南。