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

# XBOX services サンドボックスの概要

> XBOX Live サービス構成を開発サンドボックスに公開する方法、サンドボックス ID、テストアカウント、PC および XBOX コンソールでのサンドボックス切り替え方法を学びます。

## XBOX services 開発用のサンドボックスのセットアップ

ゲームから XBOX services を使用する前に、[Partner Center](https://partner.microsoft.com/dashboard) でオンライン上のタイトル情報を構成する必要があります。この情報には、タイトルで表示したいリーダーボード、プレイヤーが解除できる実績、マッチメイキング構成などの機能が含まれます。

サービス構成に変更を加えたときは、その変更が XBOX services に反映される前に、Partner Center から公開する必要があります。公開先は*開発サンドボックス* — ライブバージョンに影響を与えることなくタイトルの作業を行える隔離された環境です。

デフォルトでは、XBOX One (以降) コンソールおよび Windows 10 (以降) の PC は **RETAIL** サンドボックスに設定されています。

詳細については、[XBOX services サンドボックスの詳細](/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes) も参照してください。

## この記事の内容

* [サンドボックスの利点](#benefits-of-sandboxes)
* [サンドボックス ID](#sandbox-ids)
* [どのデータがサンドボックス化されるか?](#what-data-is-sandboxed)
* [テストアカウント](#test-accounts)
* [複数のサンドボックスの使用](#using-multiple-sandboxes)
* [PC でサンドボックスをセットアップする](#set-up-your-sandbox-on-pc)
* [コンソールでサンドボックスをセットアップする](#set-up-your-sandbox-on-console)

***

## サンドボックスの利点

開発サンドボックスにはいくつかの利点があります:

* **安全にイテレーションできる。** 現在利用可能なバージョンに影響を与えることなく、タイトルのサービス構成に変更を加えることができます。
* **ツールへのアクセス。** セキュリティ上の理由から、一部のツールは開発サンドボックスでのみ動作します。
* **構成のブランチ化。** チームの開発者は、お互いに影響を与えることなく、別々のサンドボックスでサービス構成の変更をテストできます。
* **プライバシー。** 他の発行元は、サンドボックスへのアクセス権が付与されない限り、あなたが取り組んでいる内容を見ることができません。

## サンドボックス ID

各サンドボックスは、**大文字と小文字を区別する**一意の識別子を持ちます。開発サンドボックスは、発行元のモニカに基づく命名規則 (例: `XDKS.1` や `XLDP.5`) に従います。

これらは Sandbox ID と呼ばれ、場合によっては Sandbox Name とも呼ばれます。

<Info>サンドボックス ID は**大文字と小文字を区別します**。`XDKS.1` は `xdks.1` や `Xdks.1` と同じではありません。ただし、**XblPCSandbox.exe** ツールは、PC でサンドボックスを切り替えるときに大文字小文字を自動的に修正します。すべてのサンドボックス ID は大文字です。確定的なサンドボックス ID については、常に Partner Center を参照してください。</Info>

## どのデータがサンドボックス化されるか?

すべての XBOX services データがサンドボックスの影響を受けるわけではありません。**サンドボックス化された**データはサンドボックスごとに分離されており、作成されたサンドボックス内にのみ存在し、他のサンドボックスからは見えません。**サンドボックス化されていない**データは、RETAIL を含むすべてのサンドボックス間でグローバルに共有されます。

| 機能                              | サンドボックス化? |
| ------------------------------- | --------- |
| 実績、リーダーボード、統計情報                 | はい        |
| サービス構成 (実績、リーダーボード、セッションテンプレート) | はい        |
| ソーシャル情報 (フレンド、フォロワー)            | いいえ       |

**主な影響:**

* あるサンドボックスで獲得した実績は、別のサンドボックスに引き継がれません。
* 異なるサンドボックスのユーザー同士はマッチングやマルチプレイができません。
* あるサンドボックスに公開されたサービス構成は、別のサンドボックスでは表示されません。

## テストアカウント

個人の XBOX アカウントの代わりに、開発およびテスト用に [テストアカウント](/services/xbox-services/develop/test-accounts/live-test-accounts) を作成できます。

これはサンドボックスで作業するための推奨オプションです。

テストアカウント:

* 開発サンドボックスに**のみ**サインインできます (RETAIL にはサインインできません)。
* 特定のサンドボックスへのアクセス権を付与できます。
* Partner Center で確認および管理できる**有効期限**を設定できます。
* ソーシャル対話やマルチプレイなどのシナリオをテストできる**子アカウント**を持つことができます。

<Tip>テストアカウントでのサインインに問題がある場合は、[サインインおよびサンドボックスエラーのトラブルシューティング](/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes) セクションを参照してください。</Tip>

詳細については、[テストアカウント](/services/xbox-services/develop/test-accounts/live-test-accounts) も参照してください。

## 複数のサンドボックスの使用

複数のサンドボックスは、より高度なシナリオで役立ちます:

* **サービス構成の分離。** アクティブな開発用に*Development* サンドボックス、QA チーム用に*Testing* サンドボックスを使用します。*Development* に公開した変更は、テスターに見える内容には影響しません。
* **マルチプレイの分離。** 開発者とテスターを別々のサンドボックスに配置し、テスト中にマッチメイキングで両グループが混ざらないようにします。

<Note>**XBOX Creators Program** に属している場合、サンドボックスは 1 つしか持てません。複数のサンドボックスを作成するには、**Managed Partners Program** に属している必要があります。</Note>

サンドボックスの分離、製品インスタンス、複数組織のシナリオに関する詳細については、[XBOX services サンドボックスの詳細](/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes) を参照してください。

## サンドボックスがワークフローにどのように適合するか

サンドボックスを使用する際の典型的なワークフローは次のとおりです:

1. **デバイスを切り替える** — 開発サンドボックスに切り替えます。構成する予定の環境に応じて、以下の [PC](#set-up-your-sandbox-on-pc) または [Console](#set-up-your-sandbox-on-console) の手順を参照してください。
2. **変更を公開する** — サービス構成をイテレーションしながら、開発サンドボックスに変更を公開します。
3. **アクセスを共有する** — 同じサンドボックスで作業する必要があるチームメンバーとアクセスを共有します。
4. **RETAIL に戻る** — リテール環境でテストしたり、システムアプリを更新したり、他のゲームをプレイする必要があるときは RETAIL に戻ります。

***

## PC でサンドボックスをセットアップする

### XblPCSandbox.exe を使用してサンドボックスを切り替える (推奨)

**XblPCSandbox.exe** は GDK に含まれるコマンドラインツールです。PC でサンドボックスを切り替える推奨方法です。

XblPCSandbox.exe の使用方法と各引数についての詳細情報は、[XBOX Live PC Sandbox Switcher (XblPCSandbox.exe)](/tools/tools-services/live-pc-sandbox-switcher) を参照してください。

***

## コンソールでサンドボックスをセットアップする

このセクションでは、XBOX One (以降) のコンソールを開発サンドボックスに切り替えて、XBOX services を使用したゲームのテストを行う方法について説明します。

### XBOX Device Portal を使用する

XBOX Device Portal を使用してコンソールのサンドボックスを変更できます。これを行うには、コンソール上の "Dev Home" に移動して有効にします。

その後、PC の Web ブラウザに IP アドレスを入力してコンソールに接続できます。**XBOX Live** を選択して、テキストボックスにサンドボックスを入力できます。

### XBOX Manager を使用する

XBOX Manager は XBOX One 以降のコンソール用です。

XBOX Manager を使用すると、PC からコンソールの特定の側面を管理できます。これには、再起動、インストール済みアプリの管理、サンドボックスの変更などが含まれます。

サンドボックスを変更したいコンソールを右クリックして、**Settings...** に移動します。

そこでサンドボックスを入力できます。

### XBOX コンソール UI を使用する

XBOX One (以降) コンソールから直接、開発サンドボックスを変更したい場合は、**Settings** に移動できます。次に、**Developer Settings** に移動すると、サンドボックスを変更するオプションが表示されます。

***

## 次のステップ

サンドボックスの切り替え中に問題が発生した場合は、ガイド付き診断プロセスとエラーコードリファレンスについて、[サインインおよびサンドボックスエラーのトラブルシューティング](/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes) に進んでください。

## 関連項目

* [サンドボックスの詳細概念概要](/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes)
* [テストアカウント](/services/xbox-services/develop/test-accounts/live-test-accounts)
* [サインインおよびサンドボックスエラーのトラブルシューティング](/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes)
* [XblPCSandbox.exe リファレンス](/tools/tools-services/live-pc-sandbox-switcher)
* [XBOX services 構成の概要](/services/xbox-services/fundamentals/portal-config/live-portal-config-overview)
* [MicrosoftGame.config の概要](/build/core-features/common/game-config/MicrosoftGameConfig-Overview)