跳转到主要内容
受众是已命名的一组玩家或设备(例如测试人员),卖家可以将内容定向到这些受众。Partner Center 将其称为客户组。audience 命令可列出和获取卖家的受众、创建已知用户受众,以及重命名受众或替换其成员。若要允许某个受众加入游戏测试,请将其 id 传递给 playtest create 或 playtest update;请参阅 选择受众。 audience 属于实验性命令:其命令、选项和输出可能会更改或被删除。请参阅 实验性命令。列出和获取受众需要具有该卖家的 Partner Center 客户组“读取”权限,创建和更新受众则需要“写入”权限。

命令

CLI 无法删除受众或更改其类型;请在 Partner Center 中执行这些操作。

参数和选项

输出

audience get 写入一个受众:
audience list 写入一个由相同对象组成的 audiences 数组,不包含 members;如果没有受众,则写入 {"audiences":[]}。create 和 update 以与 get 相同的方式写入受众。 使用 --output table 时,每个命令都会显示 ID、NAME 和 TYPE 列,其中 TYPE 为 groupType。成员仅出现在 JSON 输出中。

创建受众

如果不使用 --members-file,受众将没有成员。每次运行都会创建一个新受众,即使已存在同名受众也是如此。

更新受众

传递 --name、--members-file 或两者;未指定的内容会保留。以下命令重命名受众:
以下命令将其成员替换为 testers.txt 中的地址:
--members-file 会替换完整的成员列表。不在文件中的成员会被删除,空文件会删除所有成员。若要添加或删除一个成员,请使用 audience get 读取列表,对其进行更改,然后传递整个列表。
更新不会针对其他更改进行检查:如果两个人同时更新某个受众,则以最后一次更新为准。

成员文件

成员文件是 UTF-8 文本,每行一个电子邮件地址,最多 1000 个成员:
空行以及每行前后的空格会被忽略。服务会检查每个成员,但已存储的成员并不能证明它会解析为可以看到定向到该受众的内容的帐户。

退出代码

create 和 update 只发送一次请求。以代码 3 退出后,请在再次运行命令之前进行检查:
  • 在 create 之后,运行 stderr 中显示的 xbox audience list --name 命令。匹配项只是一个 提示,因为名称不必唯一,并且再次运行 create 可能会创建第二个受众。
  • 在 update 之后,运行 xbox audience get <audience-id> 以检查其名称和成员。

错误

无论 --output 是什么,错误都会以文本形式输出到 stderr,其中包含关联 ID、针对 HTTP 状态的指导,以及服务的错误详细信息(如果有)。--verbose 会添加服务的响应,其中可能包含成员。脚本应根据退出代码而不是措辞进行分支。 403 可能表示缺少权限、你不属于该卖家,或者未为该卖家启用游戏测试。对于 list 和 get,拒绝也可能显示为 502;请检查错误详细信息以了解原因。创建和更新受众的功能正在逐步推出,你可能尚无法使用;在此之前,create 和 update 会失败,且不会更改任何内容。

示例

列出和获取受众:
创建受众,不显示确认提示:
替换受众的成员,并以表格形式显示结果:
最后修改于 2026年11月19日