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 中的地址:
成员文件
成员文件是 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 会失败,且不会更改任何内容。
