> ## 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 サービスと実績から、公表解禁と RETAIL への公開まで、プレイテストに向けてゲームの XBOX サービス構成を準備します。

プレイテストは、プレイヤーが使用するライブ環境である RETAIL サンドボックスで実行されます。ビルドで
XBOX サインイン、実績、プレゼンス、その他の XBOX サービスを使用する場合、ゲームには完全な XBOX サービスが必要であり、
その XBOX サービス構成を RETAIL に公開する必要があります。これにより、テスターはリリース済みゲームのプレイヤーと
同じライブの XBOX サービスを使用します。
[XBOX サービスと Playtest](https://docs.xbox.com/publishing/game-publishing/concepts/playtest-preview.md#xbox-services-and-playtest)を参照してください。

[プレイテストを作成する](https://docs.xbox.com/ja-jp/tools/xbox-cli/first-playtest.md)前に、次の手順を一度実行します。

1. [完全な XBOX サービスを取得する](#1-get-full-xbox-services)。
2. [実績の扱いを決める](#2-choose-what-happens-to-achievements)。
3. [公表解禁を設定する](#3-set-the-embargo)。
4. [構成を RETAIL に公開する](#4-publish-the-configuration-to-retail)。

例では、XBOX タイトル ID `1234ABCD` と、ビルドのテストに使用した構成を保持する開発サンドボックス `XDKS.1` を
使用しています。

## 1. 完全な XBOX サービスを取得する

新しいゲームは、XBOX サービスが無効の状態で開始されます。制限付き XBOX サービスは開発サンドボックスでのみ動作し、
実績や統計は含まれません。ゲームのコンセプトが承認されたら、ゲームの Store ID を XBOX の担当者に送信し、
製品のオンボーディングを依頼します。その後、パートナー センターのゲームの **Game setup** ページで
**Enable full XBOX services** を選択します。
[XBOX サービスを有効にする](https://docs.xbox.com/publishing/game-publishing/concepts/xbox-services.md#enable-xbox-services)を参照してください。

それまでは、実績を含む構成は検証に失敗します。

```text theme={null}
XblLimited products do not support achievements or stats2013/stats2015 configuration.
```

## 2. 実績の扱いを決める

RETAIL に公開された実績は永続的です。名前、説明、アートは引き続き変更できますが、実績を削除したり、
ロック解除のルールやゲーマースコアを変更したりすることはできません。RETAIL に公開された統計も削除できません。
ゲームの実績システム (タイトルで管理される実績またはイベントベースの実績) は、最初の RETAIL への公開で
確定します。その公開の前に、次のいずれかを選択します。

| 選択肢 | 使用する場合 | 方法 |
| - | - | - |
| 最終的な実績を公開する | 実績が確定している場合。 | 通常どおり公開します。未リリースのゲームの場合、次の手順の公表解禁によって、他のプレイヤーには実績が表示されなくなります。 |
| 検証オーバーライドを依頼する | プレイテスト中に実績の設計を変更する必要がある場合。 | XBOX の担当者に開発時の検証オーバーライドを依頼します。ゲームをサーティフィケーションに提出する前に、オーバーライドを解除してください。 |

PC または XBOX 本体向けのゲームでは、実績の RETAIL への公開を省略できません。パートナー
センターで **Publish Achievements to Retail?** に **No** と回答すると、次のエラーで失敗します。

```text theme={null}
The specified Platform:Windows can be used only when game is configured to Publish Achievements.
```

公開するすべての実績は、実績とゲーマースコアに関する XBOX 要件を満たす必要があります。
[実績](https://docs.xbox.com/publishing/game-publishing/concepts/playtest-preview.md#achievements)を参照してください。

## 3. 公表解禁を設定する

公表解禁を設定すると、指定した日付まで、XBOX アプリと本体の UI でゲームの実績、プレゼンス、その他の XBOX サービスのデータが
プレイヤーに表示されなくなり、スクリーンショットとビデオのキャプチャもブロックされます。
公表解禁を設定しないと、プレイテスト外のプレイヤーにもゲームの構成が表示される可能性があります。

公表解禁は、まだリリースされていないゲームに対してのみ設定してください。リリース済みのゲームに新しい公表解禁を設定すると、
そのゲームのプレイヤーに XBOX サービスのデータが表示されなくなります。

パートナー センターで **XBOX services** > **XBOX settings** を開き、**Embargo date** に移動して、
プレイテストの終了より後で、ゲームの一般リリース以前の UTC の日時を設定します。
プレイテストがリリース後も続く場合は、リリース時に公表解禁を終了します。テスターが互いをマルチプレイヤー セッションに
招待する場合は、**Allow Multiplayer Invites in Embargo** を選択します。
[公表解禁日を構成する](https://docs.xbox.com/publishing/game-publishing/tutorial-xbox-managed/how-to-configure-xbox-services.md#configure-embargo-date)を参照してください。

公表解禁はタイトル全体の設定であり、`ALL` サンドボックスに保存され、すべてのサンドボックスに適用されます。
確認するには、`ALL` をダウンロードします。

```bash theme={null}
xbox xbl config download --title-id 1234ABCD --sandbox-id ALL --view draft --dest xbox-config-all
```

`productdeveloper.xml` に公表解禁の設定が含まれています。

```xml theme={null}
<XboxLiveEmbargoDate>2027-03-01T17:00:00Z</XboxLiveEmbargoDate>
<EmbargoInvitesEnabled>true</EmbargoInvitesEnabled>
```

公表解禁は、タイトル全体の構成が公開されたときに有効になります。パートナー センターに未公開の変更が表示されている場合は、
パートナー センターで公開するか、`--sandbox-id HIDDEN` を指定して公開します。

> [!WARNING]
>
> タイトル全体の公開では、公表解禁だけでなく、保留中のタイトル全体の変更がすべて公開され、それらの
> 変更は RETAIL にも反映されます。先に保留中の変更を確認してください。

```bash theme={null}
xbox xbl config publish --title-id 1234ABCD --sandbox-id HIDDEN
```

このコマンドは、公開する前に確認を求めます。
[ソースの選択](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/xbl.md#source-selection)を参照してください。

公開は非同期で行われます。RETAIL に公開する前に、`lastPublish` でタイトル全体の公開が成功したことを
確認します。

```bash theme={null}
xbox xbl config status --title-id 1234ABCD --sandbox-id HIDDEN
```

## 4. 構成を RETAIL に公開する

開発サンドボックスの構成を RETAIL に直接公開します。RETAIL では、事前の CERT への
公開やサーティフィケーションは必要ありません。

> [!WARNING]
>
> RETAIL への公開は、完了するとすぐにプレイヤーに対して有効になり、公開された実績は
> 削除できません。[安全性と破壊的な操作](https://docs.xbox.com/ja-jp/tools/xbox-cli/safety.md)を参照してください。

まず検証します。検証では何も変更されず、公開によって追加される実績が一覧表示されます。

```bash theme={null}
xbox xbl config publish --title-id 1234ABCD \
  --source-sandbox-id XDKS.1 --sandbox-id RETAIL --validate-only
```

検証で `FirstRetailPublishWithoutEffectiveEmbargo` 警告が表示される場合は、まだ公表解禁が有効に
なっていません。タイトル全体の公開を含め、[手順 3](#3-set-the-embargo) を完了してください。

`XDKS.1` から公開すると、RETAIL の同じ名前の作業ドキュメントと、
RETAIL のグローバル タイトル ストレージ ファイルが置き換えられ、RETAIL にのみ存在するファイルは削除されます。
[サンドボックス間の公開](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/xbl.md#cross-sandbox-publishing-replaces-global-title-storage-files)を参照してください。

検証で問題がなければ、公開します。このコマンドは公開の内容を説明し、最初に確認を求めます。

```bash theme={null}
xbox xbl config publish --title-id 1234ABCD --source-sandbox-id XDKS.1 --sandbox-id RETAIL
```

公開が完了するまで `lastPublish` を確認します。

```bash theme={null}
xbox xbl config status --title-id 1234ABCD --sandbox-id RETAIL
```

その後、[プレイテストを作成して公開します](https://docs.xbox.com/ja-jp/tools/xbox-cli/first-playtest.md)。


## Related topics

- [最初のプレイテスト](https://docs.xbox.com/ja-jp/tools/xbox-cli/first-playtest.md)
- [RETAIL サンドボックスでのテストに関する推奨事項](https://docs.xbox.com/ja-jp/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-recommendations-for-testing-in-retail.md)
- [サンドボックス](https://docs.xbox.com/ja-jp/publishing/game-publishing/concepts/sandboxes.md)
- [XBOX CLI](https://docs.xbox.com/ja-jp/tools/xbox-cli/index.md)
- [Playtest](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/playtest.md)
