開始之前
- 一個已設定為可開發 XBOX 遊戲且其中有遊戲的 Partner Center 帳戶。試玩測試不需要另外要求存取權。
- 遊戲的年齡分級。在 Partner Center 中遊戲的 Age ratings 頁面上,完成一次 International Age Rating Coalition (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 Game Development Kit (GDK) 中的makepkg 上傳組建。若為組建位於 layout 資料夾中的 PC 遊戲:
STATE 為 Processed 且 PLAYTEST 為 true 時,套件就準備就緒。請記下其 PACKAGE ID。表格不會顯示驗證結果,因此請在 JSON 中確認其 validationItems 不包含嚴重性為 Error 的項目:
STATE 為 ProcessFailed、PLAYTEST 維持為 false,或有 Error 項目,請查看試玩測試的必要條件中的套件需求。
2. 建立對象
對象會決定誰可以安裝試玩測試。Partner Center 將其稱為客戶群組。在 Partner Center 的 Apps and games 工作區中,選取 Customer groups,然後選取 Create new group。選擇 Known user group、新增您的測試人員,然後儲存。 或者,在testers.txt 中列出測試人員的電子郵件地址 (每行一個),並使用實驗性的 audience create 命令建立對象:
id,以便將其新增至試玩測試。
3. 建立試玩測試
如果您使用audience create 建立對象,請使用它列印的 id。如果您在 Partner Center 中建立群組,請找出其 ID:
xbox audience list 逾時 (這是已知問題),請在建立試玩測試時省略 --audience-id。之後,在 Partner Center 中,從遊戲 Services 下的 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. 分享
試玩測試上線後,其對象中的測試人員就可以在其收藏庫中找到它:- 在主機上,位於 Full Library 的 Playtest 篩選條件下。
- 在 PC 上,位於 XBOX 應用程式 Library 的 Access 篩選條件下。
msxbox://playtest/ 開頭的連結。CLI 目前還無法顯示此連結。此連結只適用於試玩測試對象中的人員,而在 PC 上,它會在 XBOX 應用程式中開啟試玩測試。請參閱與測試人員分享試玩測試。
指令碼和持續整合
您可以使用服務主體從持續整合 (CI) 管線上傳套件。請參閱上傳套件。xbox package 和 xbox playtest 命令尚不接受服務主體,因此需要已登入的使用者。請參閱自動化 (服務主體) 驗證。
在您登入時執行的指令碼中,請將 --confirm 傳遞給 playtest create 和 playtest publish,因為沒有終端機時,它們無法詢問您,也不會進行任何變更。請讀取它們列印的 JSON,並檢查其結束代碼。若要等候發佈超過 5 分鐘,請傳遞 --timeout。