跳转到主要内容
游戏测试让一组选定的玩家在发布前试玩游戏。playtest 命令读取 Partner Center 中游戏的游戏测试,并创建、更新、发布和删除它们。create、update、publish 和 delete 在进行更改之前会进行询问。 create、update、publish 和 delete 属于实验性命令:其选项和输出可能会更改或被删除。请参阅实验性命令。

命令

参数和选项

示例

列出游戏测试、获取一个游戏测试并比较两个游戏测试:
为受众创建游戏测试:
更改游戏测试的结束日期:
发布游戏测试:
删除游戏测试:

读取游戏测试

playtest list 写入一个 playtests 数组。其表格包含 PLAYTEST ID、NAME、STATUS、TYPE、START 和 END 列。摘录:
playtest get 按服务返回的原样写入游戏测试。etag 是要传递给 update --if-match 的版本,audiences.audienceIds 列出可以加入的受众。其表格包含 FIELD 和 VALUE 行。 playtest diff 写入 hasDiffData、current 和 compared。当 hasDiffData 为 false 时,没有可比较的内容,并且会省略 compared。其表格仅在 FIELD、CURRENT 和 COMPARED 列中显示有差异的字段。不比较图像。

创建游戏测试

playtest create 创建一个专用草稿游戏测试,并按照 playtest get 的方式将其写出。再次运行会创建另一个游戏测试;使用 playtest delete 删除你不需要的游戏测试。 每次创建都会发送一个幂等键;除非你传递 --idempotency-key,否则它是一个新的 GUID。重复使用某个键的创建会返回该键创建的游戏测试,并忽略任何不同的选项。 当结果未知时(例如超时之后),命令以 3 退出,并打印一个使用相同键重试的命令:
如果第一个请求已创建游戏测试,重试会返回该游戏测试,否则会创建它。当某个选项包含换行符时,只会打印键;请使用 --idempotency-key 和该键运行相同的命令。如果重试被拒绝(例如因为结束日期已过),请先检查 playtest list,然后再使用新键创建游戏测试。

程序包

一个游戏测试可以有一个 PC 程序包和一个主机程序包。从 xbox package list 中选择一个已可用于游戏测试的程序包,并将其 id 传递给对应其平台的选项:
在 update 中,省略的程序包选项会保留其程序包,新 ID 会替换它,"" 会删除它:

更新游戏测试

任何更新都会使已发布的游戏测试恢复为草稿,这与在 Partner Center 中编辑它的效果相同。请使用 playtest publish 再次发布它,使其可供玩家使用。
playtest update 仅更改你传递的选项,并且至少需要一个选项。它按照 playtest get 的方式写出更新后的游戏测试。在 Partner Center 中配置的游戏图稿会被保留;链接到游戏测试的其他图稿会被替换为占位符。 为避免覆盖他人的更改,请在 --if-match 中传递来自 playtest get 的 etag。其两侧的双引号是可选的,*、弱 (W/) etag 和 etag 列表会被拒绝:
当结果未知时,命令以 3 退出。重试之前,请使用 playtest get 检查游戏测试。

选择受众

受众是卖家在 Partner Center 中管理的一组玩家,例如测试人员。将来自 audience list 的 id 传递给 --audience-id,重复此选项可添加更多受众:
如果不使用 --audience-id,create 会创建一个没有受众的游戏测试,而 update 会保留现有受众。在 update 中,你传递的 ID 会替换游戏测试的所有受众。若要删除所有受众,请仅传递 "":
"" 不能与受众 ID 结合使用,create 会拒绝它。游戏测试至少需要一个受众才能发布。

发布游戏测试

如果游戏使用 XBOX 服务,请在发布之前设置其配置和禁运。请参阅在游戏测试中使用 XBOX 服务。
发布会从开始日期起向受众提供游戏测试。该命令发布它首先读取的版本;如果游戏测试在此期间发生更改,发布会以 412 失败,且不会更改任何内容。 在要求你确认之前,该命令会检查游戏的 XBOX 服务设置(例如其禁运日期是否晚于游戏测试的结束日期),并在 stderr 上列出需要查看的任何内容。这些检查仅供参考;--confirm 会直接发布而不询问。 然后,服务会运行自己的检查。当某项检查阻止发布时,不会将任何内容加入队列,命令会在 stderr 上列出每项检查并以 1 退出。修复错误后再次发布。因缺少年龄分级而被阻止的游戏测试需要在 Partner Center 中完成年龄分级调查问卷。 发布进入队列后,命令会等待游戏测试变为 Scheduled、Live 或 PublishFailed,并按照 playtest get 的方式将其写出。按 Ctrl+C 会停止等待,但发布会继续进行。使用 --no-wait 时,命令会在发布进入队列后立即写入 publishJobId 和任何 warnings;之后请使用 playtest get 跟踪它。

删除游戏测试

playtest delete 删除它首先读取的游戏测试版本。它会等待游戏测试变为 Deleted 或消失,然后写入服务的响应(包含 status)。按 Ctrl+C 会停止等待,但删除会继续进行。使用 --no-wait 时,它会在删除进入队列后立即写入响应。出现 412 后,删除可能已进入队列,因此请等待一分钟,并在再次删除之前使用 playtest get 进行检查。

日期

--start 和 --end 接受 ISO 8601 日期和时间,例如 2026-11-01T09:00:00-07:00 或 2026-11-01T16:00:00Z。不带时间的日期表示 UTC 午夜,不带偏移量的时间为 UTC。当更新仅传递一个日期时,服务会将其与游戏测试的另一个日期进行核对。

错误

除非上面的退出代码表另有说明,否则失败信息会写入 stderr,并以 1 退出。当结果未知时,create 和 update 以 3 退出。服务返回的失败包括其 HTTP 状态,--verbose 会添加服务的响应,其 code 字段如下所示: 对于其他失败,命令会显示服务的消息。429 表示你发送的请求过多;请按照消息所述等待相应时长后再重试。
最后修改于 2026年11月19日