メインコンテンツへスキップ
プレイテストを使用すると、選ばれたプレイヤー グループが、リリースの前後を問わず、サーティフィケーションや Microsoft Store の 登録情報なしで、XBOX 本体と PC にゲームのビルドをインストールできます。このページでは、ビルドの アップロードから、テスターとのプレイテストの共有までを説明します。 プレイテストのしくみについては、Playtest の概要で 説明しています。 このページのほとんどのコマンドは試験段階 (Experimental) であるため、オプションと出力が変更される可能性があります。 試験段階のコマンドを参照してください。

始める前に

  • XBOX ゲームを開発できるようにセットアップされ、ゲームが含まれているパートナー センター アカウント。プレイテストに 別途アクセスを申請する必要はありません。
  • ゲームの年齢別レーティング。パートナー センターのゲームの Age ratings ページで、International Age Rating Coalition (IARC) の 質問票に一度回答します。年齢別レーティングがないと、プレイテストは 公開できません。
  • パートナー センターでゲームのパッケージを管理する権限。この権限がないと、package コマンドと playtest コマンドは 403 package_permission_denied で失敗します。パートナー センター アカウントの管理者に 権限を依頼するか、ゲームが別の販売者に属している場合は --seller-id を渡してください。
  • はじめにの説明に従って、xbox auth login でサインインし、販売者を選択します。
プレイテストは RETAIL サンドボックスで実行されます。ビルドで XBOX サインインやその他の XBOX サービスを使用する場合は、 先にプレイテストで XBOX サービスを使用するの手順に従ってください。 例では Store ID 9N0000000000 を使用しています。ゲームの Store ID は、 xbox game list --output table で確認できます。

1. パッケージをアップロードする

CLI はパッケージをアップロードしません。October 2026 XBOX Game Development Kit (GDK) 以降の makepkg で ビルドをアップロードします。ビルドが layout フォルダーにある PC ゲームの場合は、次のようにします。
その他のパッケージ形式については、makepkg リファレンス を参照してください。その後、パートナー センターでパッケージが処理されます。これにはしばらく時間がかかる場合があります。 状態を確認するには、次のようにします。
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 時を意味します。
このコマンドは、プレイテストを作成する前に確認を求め、作成後にプレイテストを JSON として出力します。プレイテストの ID (details の下の playtestId) を控えておきます。 コマンドが 3 で終了した場合は、プレイテストが作成されたかどうかを判断できなかったことを意味します。出力された コマンドで再試行してください。これにより、2 つ目のプレイテストが作成されることはありません。

4. 公開する

手順 3 の ID を使用してプレイテストを公開します。
このコマンドは、プレイテストが Live (開始日がまだ来ていない場合は Scheduled) になるまで待機し、 0 で終了します。その他の終了コードは、プレイテストがまだ公開されていないことを意味します。 プレイテストの公開を参照してください。

5. 共有する

プレイテストがライブになると、その対象ユーザーに含まれるテスターはライブラリでプレイテストを見つけることができます。
  • 本体では、Full Library の Playtest フィルターの下に表示されます。
  • PC では、XBOX アプリの ライブラリ の Access フィルターの下に表示されます。
新しく追加されたテスターは、まずいったんサインアウトしてから、もう一度サインインする必要があります。 テスターにリンクを送信することもできます。パートナー センターのゲームの Playtest ページで、プレイテストの Share を選択し、msxbox://playtest/ で始まるリンクをコピーします。CLI では、このリンクをまだ 表示できません。このリンクはプレイテストの対象ユーザーに含まれるユーザーに対してのみ機能し、PC では XBOX アプリで プレイテストが開きます。 テスターとプレイテストを共有するを参照してください。

スクリプトと継続的インテグレーション

継続的インテグレーション (CI) パイプラインから、サービス プリンシパルを使用してパッケージをアップロードできます。 パッケージのアップロードを参照してください。xbox package コマンドと xbox playtest コマンドはまだサービス プリンシパルを受け入れないため、サインインしているユーザーが必要です。 自動化 (サービス プリンシパル) の認証を参照してください。 サインインした状態で実行するスクリプトでは、playtest create と playtest publish に --confirm を渡してください。 ターミナルがないとこれらのコマンドは確認を求めることができず、何も変更しないためです。出力される JSON を読み取り、 終了コードを確認してください。公開を 5 分より長く待機するには、--timeout を渡します。
最終更新日 2026年11月19日