跳轉到主要內容
對象是具名的玩家或裝置群組 (例如測試人員),賣方可以將內容鎖定給這些群組。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,其中包含相互關聯識別碼、針對 HTTP 狀態的指引,以及服務的錯誤詳細資料 (如果有的話)。--verbose 會加入服務的回應,其中可能包含成員。指令碼應根據結束代碼而非文字內容來分支。 403 可能表示缺少權限、您不屬於該賣方,或該賣方未啟用試玩測試。在 list 和 get 上,拒絕可能會改以 502 呈現;請檢查錯誤詳細資料以了解原因。建立及更新對象的功能正在逐步推出,您可能尚無法使用;在推出之前,create 和 update 會失敗,且不會變更任何內容。

範例

列出及取得對象:
建立對象而不顯示確認提示:
取代對象的成員,並以表格顯示結果:
最後修改於 2026年11月19日