开始之前
- 一个已设置为开发 XBOX 游戏的 Partner Center 帐户,其中包含一个游戏。游戏测试无需单独申请访问权限。
- 游戏的年龄分级。在 Partner Center 中游戏的年龄分级页面上,完成一次国际年龄分级联盟 (IARC) 问卷。没有年龄分级,就无法发布游戏测试。
- 在 Partner Center 中管理游戏程序包的权限。如果没有此权限,
package和playtest命令会失败,并显示 403package_permission_denied。请向你的 Partner Center 帐户的管理员申请此权限;如果游戏属于另一个卖家,请传递--seller-id。 - 使用
xbox auth login登录并选择卖家,如入门中所述。
9N0000000000。可以使用
xbox game list --output table 查找你的游戏的 Store ID。
1. 上传程序包
CLI 不会上传程序包。请使用 2026 年 10 月或更高版本的 XBOX 游戏开发工具包 (GDK) 中的makepkg 上传版本。对于版本位于 layout 文件夹中的 PC 游戏:
STATE 为 Processed 且 PLAYTEST 为 true 时,程序包即准备就绪。记下其 PACKAGE ID。
表格不显示验证结果,因此请在 JSON 中检查其 validationItems 不包含严重级别为 Error 的项:
STATE 为 ProcessFailed、PLAYTEST 保持为 false,或者存在 Error 项,请查看游戏测试的先决条件中的程序包要求。
2. 创建受众
受众决定谁可以安装游戏测试。Partner Center 将其称为客户组。在 Partner Center 的应用和游戏工作区中,选择客户组,然后选择创建新组。选择已知用户组,添加你的测试人员,然后保存。 或者,在testers.txt 中列出测试人员的电子邮件地址(每行一个),然后使用实验性的
audience create 命令创建受众:
id,以便将其添加到游戏测试中。
3. 创建游戏测试
如果你使用audience create 创建了受众,请使用它输出的 id。如果你在 Partner Center 中创建了组,请查找其 ID:
xbox audience list 超时(这是一个已知问题),请在创建游戏测试时省略 --audience-id。之后,在 Partner Center 中,从服务下游戏的 Playtest 页面打开该游戏测试,选择步骤 2 中的组,然后保存但不发布。
创建游戏测试:
--pc-package-id采用步骤 1 中的程序包 ID。对于主机程序包,请使用--console-package-id。--audience-id采用受众的 ID。重复此选项可添加更多受众。- 测试人员可以在
--start到--end期间安装游戏测试。不含时间的日期表示 UTC 午夜。
details 下的 playtestId。
如果命令以 3 退出,则表示它无法判断游戏测试是否已创建。请使用它输出的命令重试,该命令不会创建第二个游戏测试。
4. 发布游戏测试
使用步骤 3 中的 ID 发布游戏测试:Live(如果其开始日期尚未到来,则为 Scheduled),然后以 0 退出。其他退出代码表示游戏测试尚未发布:
请参阅发布游戏测试。
5. 共享游戏测试
游戏测试上线后,其受众中的测试人员可以在自己的库中找到它:- 在主机上,位于完整库中的 Playtest 筛选器下。
- 在 PC 上,位于 XBOX 应用的库中的访问筛选器下。
msxbox://playtest/ 开头的链接。CLI 目前还无法显示此链接。该链接仅适用于游戏测试受众中的人员,在 PC 上,它会在 XBOX 应用中打开游戏测试。请参阅
与测试人员共享游戏测试。
脚本和持续集成
你可以使用服务主体从持续集成 (CI) 管道上传程序包。请参阅 上传程序包。xbox package 和
xbox playtest 命令尚不接受服务主体,因此它们需要已登录的用户。请参阅
自动化(服务主体)身份验证。
在你登录期间运行的脚本中,请向 playtest create 和
playtest publish 传递 --confirm,因为在没有终端的情况下,它们无法询问你,也不会进行任何更改。请读取它们输出的 JSON,并检查其退出代码。若要等待发布超过 5 分钟,请传递
--timeout。