始める前に
- XBOX ゲームを開発できるようにセットアップされ、ゲームが含まれているパートナー センター アカウント。プレイテストに 別途アクセスを申請する必要はありません。
- ゲームの年齢別レーティング。パートナー センターのゲームの Age ratings ページで、International Age Rating Coalition (IARC) の 質問票に一度回答します。年齢別レーティングがないと、プレイテストは 公開できません。
- パートナー センターでゲームのパッケージを管理する権限。この権限がないと、
packageコマンドとplaytestコマンドは 403package_permission_deniedで失敗します。パートナー センター アカウントの管理者に 権限を依頼するか、ゲームが別の販売者に属している場合は--seller-idを渡してください。 - はじめにの説明に従って、
xbox auth loginでサインインし、販売者を選択します。
9N0000000000 を使用しています。ゲームの Store ID は、
xbox game list --output table で確認できます。
1. パッケージをアップロードする
CLI はパッケージをアップロードしません。October 2026 XBOX Game Development Kit (GDK) 以降のmakepkg で
ビルドをアップロードします。ビルドが layout フォルダーにある PC ゲームの場合は、次のようにします。
STATE が Processed で、PLAYTEST が true になれば、パッケージの準備は完了です。PACKAGE ID を控えておきます。
テーブルには検証結果が表示されないため、JSON で validationItems に重大度が Error の項目が含まれていないことを
確認します。
STATE が ProcessFailed の場合、PLAYTEST が false のままの場合、または Error 項目がある場合は、
プレイテストの前提条件でパッケージの要件を確認してください。
2. 対象ユーザーを作成する
対象ユーザーによって、プレイテストをインストールできるユーザーが決まります。パートナー センターでは、これを顧客グループと呼びます。 パートナー センターの Apps and games ワークスペースで Customer groups を選択し、 Create new group を選択します。Known user group を選択してテスターを追加し、保存します。 または、テスターのメール アドレスを 1 行に 1 つずつtesters.txt に記載し、試験段階の
audience create コマンドで作成します。
id を控えておきます。
3. プレイテストを作成する
audience create で対象ユーザーを作成した場合は、出力された id を使用します。パートナー センターで
グループを作成した場合は、その ID を確認します。
xbox audience list がタイムアウトした場合 (既知の問題)、
プレイテストの作成時に --audience-id を省略します。その後、パートナー センターで Services の下にあるゲームの
Playtest ページからプレイテストを開き、手順 2 のグループを選択して、公開せずに保存します。
プレイテストを作成します。
--pc-package-idには、手順 1 のパッケージ ID を指定します。本体のパッケージには--console-package-idを 使用します。--audience-idには、対象ユーザーの ID を指定します。対象ユーザーを追加するには、このオプションを繰り返します。- テスターは、
--startから--endまでの間、プレイテストをインストールできます。時刻のない日付は UTC の午前 0 時を意味します。
details の下の playtestId) を控えておきます。
コマンドが 3 で終了した場合は、プレイテストが作成されたかどうかを判断できなかったことを意味します。出力された
コマンドで再試行してください。これにより、2 つ目のプレイテストが作成されることはありません。
4. 公開する
手順 3 の ID を使用してプレイテストを公開します。Live (開始日がまだ来ていない場合は Scheduled) になるまで待機し、
0 で終了します。その他の終了コードは、プレイテストがまだ公開されていないことを意味します。
プレイテストの公開を参照してください。
5. 共有する
プレイテストがライブになると、その対象ユーザーに含まれるテスターはライブラリでプレイテストを見つけることができます。- 本体では、Full Library の Playtest フィルターの下に表示されます。
- PC では、XBOX アプリの ライブラリ の Access フィルターの下に表示されます。
msxbox://playtest/ で始まるリンクをコピーします。CLI では、このリンクをまだ
表示できません。このリンクはプレイテストの対象ユーザーに含まれるユーザーに対してのみ機能し、PC では XBOX アプリで
プレイテストが開きます。
テスターとプレイテストを共有するを参照してください。
スクリプトと継続的インテグレーション
継続的インテグレーション (CI) パイプラインから、サービス プリンシパルを使用してパッケージをアップロードできます。 パッケージのアップロードを参照してください。xbox package コマンドと
xbox playtest コマンドはまだサービス プリンシパルを受け入れないため、サインインしているユーザーが必要です。
自動化 (サービス プリンシパル) の認証を参照してください。
サインインした状態で実行するスクリプトでは、playtest create と playtest publish に --confirm を渡してください。
ターミナルがないとこれらのコマンドは確認を求めることができず、何も変更しないためです。出力される JSON を読み取り、
終了コードを確認してください。公開を 5 分より長く待機するには、--timeout を渡します。