> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 最初のプレイテスト

> XBOX ゲームのビルドをアップロードし、XBOX CLI とパートナー センターを使用して、そのプレイテストを作成、公開、共有します。

プレイテストを使用すると、選ばれたプレイヤー グループが、リリースの前後を問わず、サーティフィケーションや Microsoft Store の
登録情報なしで、XBOX 本体と PC にゲームのビルドをインストールできます。このページでは、ビルドの
アップロードから、テスターとのプレイテストの共有までを説明します。
プレイテストのしくみについては、[Playtest の概要](https://learn.microsoft.com/gaming/game-publishing/concepts/playtest)で
説明しています。

このページのほとんどのコマンドは試験段階 (Experimental) であるため、オプションと出力が変更される可能性があります。
[試験段階のコマンド](https://docs.xbox.com/ja-jp/tools/xbox-cli/cli-command-lifecycle.md)を参照してください。

## 始める前に

* XBOX ゲームを開発できるようにセットアップされ、ゲームが含まれているパートナー センター アカウント。プレイテストに
  別途アクセスを申請する必要はありません。
* ゲームの年齢別レーティング。パートナー センターのゲームの **Age ratings** ページで、International Age Rating Coalition (IARC) の
  質問票に一度回答します。年齢別レーティングがないと、プレイテストは
  公開できません。
* パートナー センターでゲームのパッケージを管理する権限。この権限がないと、`package` コマンドと
  `playtest` コマンドは 403 `package_permission_denied` で失敗します。パートナー センター アカウントの管理者に
  権限を依頼するか、ゲームが別の販売者に属している場合は `--seller-id` を渡してください。
* [はじめに](https://docs.xbox.com/ja-jp/tools/xbox-cli/getting-started.md)の説明に従って、`xbox auth login` でサインインし、販売者を選択します。

プレイテストは RETAIL サンドボックスで実行されます。ビルドで XBOX サインインやその他の XBOX サービスを使用する場合は、
先に[プレイテストで XBOX サービスを使用する](https://docs.xbox.com/ja-jp/tools/xbox-cli/xbox-services-in-a-playtest.md)の手順に従ってください。

例では Store ID `9N0000000000` を使用しています。ゲームの Store ID は、
`xbox game list --output table` で確認できます。

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

CLI はパッケージをアップロードしません。October 2026 XBOX Game Development Kit (GDK) 以降の `makepkg` で
ビルドをアップロードします。ビルドが `layout` フォルダーにある PC ゲームの場合は、次のようにします。

```text theme={null}
makepkg upload /d layout /msixvc2 /pc /storeid 9N0000000000 /branch Main
```

その他のパッケージ形式については、[makepkg リファレンス](https://learn.microsoft.com/gaming/gdk/docs/features/common/packaging/deployment/makepkg)
を参照してください。その後、パートナー センターでパッケージが処理されます。これにはしばらく時間がかかる場合があります。
状態を確認するには、次のようにします。

```bash theme={null}
xbox package list --store-id 9N0000000000 --output table
```

`STATE` が `Processed` で、`PLAYTEST` が `true` になれば、パッケージの準備は完了です。`PACKAGE ID` を控えておきます。
テーブルには検証結果が表示されないため、JSON で `validationItems` に重大度が `Error` の項目が含まれていないことを
確認します。

```bash theme={null}
xbox package list --store-id 9N0000000000
```

`STATE` が `ProcessFailed` の場合、`PLAYTEST` が `false` のままの場合、または `Error` 項目がある場合は、
[プレイテストの前提条件](https://learn.microsoft.com/gaming/game-publishing/concepts/playtest-preview#prerequisites-for-a-playtest)でパッケージの要件を確認してください。

## 2. 対象ユーザーを作成する

対象ユーザーによって、プレイテストをインストールできるユーザーが決まります。パートナー センターでは、これを顧客グループと呼びます。
パートナー センターの **Apps and games** ワークスペースで **Customer groups** を選択し、
**Create new group** を選択します。**Known user group** を選択してテスターを追加し、保存します。

または、テスターのメール アドレスを 1 行に 1 つずつ `testers.txt` に記載し、試験段階の
[`audience create`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/audience#creating-an-audience) コマンドで作成します。

```bash theme={null}
xbox audience create --name "Nod Arena testers" --members-file testers.txt
```

プレイテストに追加するときのために、対象ユーザーの `id` を控えておきます。

## 3. プレイテストを作成する

`audience create` で対象ユーザーを作成した場合は、出力された `id` を使用します。パートナー センターで
グループを作成した場合は、その `ID` を確認します。

```bash theme={null}
xbox audience list --output table
```

`xbox audience list` がタイムアウトした場合 ([既知の問題](https://docs.xbox.com/ja-jp/tools/xbox-cli/known-issues.md#xbox-audience-list-can-time-out))、
プレイテストの作成時に `--audience-id` を省略します。その後、パートナー センターで **Services** の下にあるゲームの
Playtest ページからプレイテストを開き、手順 2 のグループを選択して、公開せずに保存します。

プレイテストを作成します。

```bash theme={null}
xbox playtest create --store-id 9N0000000000 --name "Nod Arena playtest" --start 2026-12-01 --end 2026-12-15 --pc-package-id 11111111-2222-3333-4444-555555555555 --audience-id 1152921504606846976
```

* `--pc-package-id` には、手順 1 のパッケージ ID を指定します。本体のパッケージには `--console-package-id` を
  使用します。
* `--audience-id` には、対象ユーザーの ID を指定します。対象ユーザーを追加するには、このオプションを繰り返します。
* テスターは、`--start` から `--end` までの間、プレイテストをインストールできます。時刻のない日付は
  UTC の午前 0 時を意味します。

このコマンドは、プレイテストを作成する前に確認を求め、作成後にプレイテストを JSON として出力します。プレイテストの ID
(`details` の下の `playtestId`) を控えておきます。

コマンドが `3` で終了した場合は、プレイテストが作成されたかどうかを判断できなかったことを意味します。出力された
コマンドで再試行してください。これにより、2 つ目のプレイテストが作成されることはありません。

## 4. 公開する

手順 3 の ID を使用してプレイテストを公開します。

```bash theme={null}
xbox playtest publish 11111111-2222-3333-4444-555555555555 --store-id 9N0000000000
```

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

| 終了コード | 意味 |
| - | - |
| 1 | パートナー センターのチェックが失敗しました。たとえば、プレイテストにパッケージ、対象ユーザー、または年齢別レーティングがない場合です。何も公開されていません。コマンドが一覧表示したチェック項目を修正し、もう一度公開してください。 |
| 2 | 公開が失敗しました。 |
| 3 | 結果が不明です。もう一度公開する前に、`xbox playtest get` でプレイテストを確認してください。 |
| 4 | 5 分経過してもプレイテストの公開処理が続いています。後で `xbox playtest get` で確認してください。 |

[プレイテストの公開](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/playtest.md#publishing-a-playtest)を参照してください。

## 5. 共有する

プレイテストがライブになると、その対象ユーザーに含まれるテスターはライブラリでプレイテストを見つけることができます。

* 本体では、**Full Library** の **Playtest** フィルターの下に表示されます。
* PC では、XBOX アプリの **ライブラリ** の **Access** フィルターの下に表示されます。

新しく追加されたテスターは、まずいったんサインアウトしてから、もう一度サインインする必要があります。

テスターにリンクを送信することもできます。パートナー センターのゲームの Playtest ページで、プレイテストの
**Share** を選択し、`msxbox://playtest/` で始まるリンクをコピーします。CLI では、このリンクをまだ
表示できません。このリンクはプレイテストの対象ユーザーに含まれるユーザーに対してのみ機能し、PC では XBOX アプリで
プレイテストが開きます。
[テスターとプレイテストを共有する](https://learn.microsoft.com/gaming/game-publishing/concepts/playtest-preview#share-a-playtest-with-testers)を参照してください。

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

継続的インテグレーション (CI) パイプラインから、サービス プリンシパルを使用してパッケージをアップロードできます。
[パッケージのアップロード](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/package.md#uploading-packages)を参照してください。`xbox package` コマンドと
`xbox playtest` コマンドはまだサービス プリンシパルを受け入れないため、サインインしているユーザーが必要です。
[自動化 (サービス プリンシパル) の認証](https://docs.xbox.com/ja-jp/tools/xbox-cli/authentication.md#automation-service-principal-authentication)を参照してください。

サインインした状態で実行するスクリプトでは、`playtest create` と `playtest publish` に `--confirm` を渡してください。
ターミナルがないとこれらのコマンドは確認を求めることができず、何も変更しないためです。出力される JSON を読み取り、
終了コードを確認してください。公開を 5 分より長く待機するには、`--timeout` を渡します。


## Related topics

- [Playtest の使用](https://docs.xbox.com/ja-jp/publishing/game-publishing/concepts/playtest-preview.md)
- [XBOX CLI](https://docs.xbox.com/ja-jp/tools/xbox-cli/index.md)
- [はじめに](https://docs.xbox.com/ja-jp/tools/xbox-cli/getting-started.md)
- [Playtest](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/playtest.md)
- [プレイテストで XBOX サービスを使用する](https://docs.xbox.com/ja-jp/tools/xbox-cli/xbox-services-in-a-playtest.md)
