> ## 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.

# サインインおよびサンドボックスエラーのトラブルシューティング

> XblPCSandbox、プリフライトチェックリスト、エラーコードのリファレンス、Partner Center の構成チェックを使用して、PC 上の XBOX Live サインインおよびサンドボックスエラーを診断します。

この記事は、PC 上の開発サンドボックスにおけるゲームの、一般的なサインインおよびサンドボックス関連のエラーを診断および修正するのに役立ちます。

## この記事の内容

* [プリフライトチェックリスト](#preflight-checklist)
* [診断フローチャート](#diagnostic-flowchart)
* [アカウントおよびサンドボックスエラー](#account-and-sandbox-errors)
* [構成エラー](#configuration-errors)
* [ゲーム固有のトラブルシューティング](#game-specific-troubleshooting)
* [追加のトラブルシューティング](#additional-troubleshooting)
* [エラーコードクイックリファレンス](#error-code-quick-reference)

***

## プリフライトチェックリスト

特定のエラーを調査する前に、このチェックリストを実行してください。ほとんどのサインインの問題は、これらの項目のいずれかが誤って構成されていることが原因です。以下の**すべて**を確認してから、下の診断フローチャートおよびエラーセクションに進んでください。

<Info>XblPCSandbox.exe ツールがすでにインストールされていることが重要です。
入手方法の詳細については、[サンドボックスの概要](/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox) を参照してください。</Info>

### 環境チェック

これらの項目は、XBOX App を含む XBOX services にサインインする能力に影響します。最初にこれらを確認してください。

***

### ✅ 1. サンドボックス ID に誤字がないか確認する

サンドボックス ID が正しく入力されていることを確認してください。

**確認方法:**

```cmd theme={null}
XblPCSandbox /get
```

出力を、Partner Center の **Gameplay settings** ページに表示されるサンドボックスと比較します。
これは、[https://partner.microsoft.com/en-us/xboxconfig?appid=\[productId](https://partner.microsoft.com/en-us/xboxconfig?appid=\[productId)] を使用して行うことができます。\[productId] パラメーターを対応する *Product Id* に置き換えます。

**修正方法:**

```cmd theme={null}
XblPCSandbox <your sandbox ID>
```

サンドボックスを切り替える詳細な手順については、[サンドボックスの概要](/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox) を参照してください。

***

### ✅ 2. サンドボックスが正しい

PC は、ゲームの XBOX services 構成が公開されているのと同じ開発サンドボックスに設定されている必要があります。

**確認方法:**

```cmd theme={null}
XblPCSandbox /get
```

出力を、Partner Center の **Gameplay settings** ページに表示されるサンドボックスと比較します。
これは、[https://partner.microsoft.com/en-us/xboxconfig?appid=\[productId](https://partner.microsoft.com/en-us/xboxconfig?appid=\[productId)] を使用して行うことができます。\[productId] パラメーターを対応する *Product Id* に置き換えます。

**修正方法:**

```cmd theme={null}
XblPCSandbox <your sandbox ID>
```

サンドボックスを切り替える詳細な手順については、[サンドボックスの概要](/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox) を参照してください。

***

### ✅ 3. テストアカウントが有効である

テストアカウントは、いくつかの理由で無効になる可能性があります。以下のすべてを確認してください。

#### アカウントのサンドボックスへのアクセスが期限切れになっていない

テストアカウントのサンドボックスへのアクセスには有効期限があります。サンドボックスへのアクセスが期限切れになったアカウントは、サンドボックスにサインインできません。

**確認方法:**

1. [Partner Center](https://partner.microsoft.com/dashboard) にアクセスします。
2. **Apps and Games** を選択します。
3. **XBOX Test accounts** を選択します (または [テストアカウント管理](https://partner.microsoft.com/dashboard/xbox/testaccounts) にアクセスします)。
4. テストアカウントを見つけて、**Access Expires** および **Status** 列を確認します。

**修正方法:**

アカウントが期限切れの場合、新しいテストアカウントを作成するか、既存のアカウントの有効期限を延長します。

#### アカウントがサンドボックスにアクセスできる

テストアカウントを作成する際、特定のサンドボックスへのアクセスを許可する必要があります。

**確認方法:**

1. Partner Center で、**XBOX services** > **Test accounts** に移動します。
2. テストアカウントを選択します。
3. 開発サンドボックスがアカウントのサンドボックスアクセスの下に一覧表示されていることを確認します。

**修正方法:**

テストアカウントを編集し、そのアクセスリストに開発サンドボックスを追加します。

#### 認証情報が正しい

テストアカウントの正しいメールアドレスとパスワードを使用していることを確認してください。テストアカウントのメールアドレスは、通常 `@xboxtest.com` で終わります。

***

### ✅ 4. XBOX ゲーミングコンポーネントが最新である

XBOX services は、PC 上の XBOX App と Gaming Services コンポーネントに依存しています。いずれかの古いバージョンは、予期しないサインインの失敗を引き起こす可能性があります。

**確認方法:**

1. [Game Repair Tool](https://support.xbox.com/en-MD/help/games-apps/troubleshooting/gaming-services-repair-tool) について提供されている情報に従います。

***

### ✅ 5. PC を再起動する

サインインに必要なバックグラウンドサービス (XBOX Live Auth Manager や Gaming Services など) が不正な状態になることがあります。上記の手順ではキャッチできない一時的な問題を、PC を再起動することで解決できる場合があります。

再起動する前に、Feedback Hub を通じてバグを送信することが重要です。これにより、将来のリリースで追跡および対処できるようになります。

これは、次のコマンドを使用して行うことができます。

```cmd theme={null}
XblPCSandbox /feedback
```

または、Feedback Hub から直接行う場合は、**Category: Gaming and XBOX** および **Area: Developer Tools** を選択します。

**実行するタイミング:**

上記のすべての環境チェックを確認してもサインインに失敗する場合は、PC を再起動して再試行してから、プロジェクトチェックに進んでください。

***

### プロジェクトチェック

これらの項目は、特にゲームからのサインインに影響します。XBOX App にサインインできるがゲームからサインインできない場合は、ここから始めます。

***

### ✅ 6. ID が Partner Center と一致している

`MicrosoftGame.config` の ID は、Partner Center の値と正確に一致する必要があります。1 つでも値が一致していないと、サインインできません。

**確認方法:**

`MicrosoftGame.config` を開き、これらの値を Partner Center と比較します。

| MicrosoftGame.config フィールド | Partner Center での場所                                                                   |
| -------------------------- | ------------------------------------------------------------------------------------- |
| `StoreId`                  | **Game Setup** > **Identity details** > **Show details** > Store ID                   |
| `Identity/Name`            | **Game Setup** > **Identity details** > **Show details** > Package/Identity/Name      |
| `Identity/Publisher`       | **Game Setup** > **Identity details** > **Show details** > Package/Identity/Publisher |
| `TitleId`                  | **XBOX services** > **XBOX Settings** > Title ID (**16 進数**の値、10 進数ではない)              |
| `MSAAppId`                 | **XBOX services** > **XBOX Settings** > MSA App ID (GUID または 16 進数の場合があります)           |

さらに、**SCID** (Service Configuration ID) を確認します。SCID は `MicrosoftGame.config` にはありません。これは [XblInitialize](/reference/live/xsapi-c/xbox_live_global_c/functions/xblinitialize) メソッドにパラメーターとして渡されます。Partner Center の **XBOX services** > **XBOX Settings** で確認できます。

<Tip>[MicrosoftGame.config Editor](/build/core-features/common/game-config/MicrosoftGameConfig-Editor) の **Store Association Wizard** を使用して、ゲームを自動的にリンクし、誤字の可能性を減らします。</Tip>

***

### ✅ 7. XBOX services 構成がサンドボックスに公開されている

Partner Center で変更を保存しても、開発サンドボックスに公開するまでは有効になり**ません**。

**確認方法:**

1. [Partner Center](https://partner.microsoft.com/dashboard) にアクセスします。
2. 製品を選択します。
3. **XBOX services** > **Gameplay settings** に移動します。
4. 開発サンドボックスのタブを選択します。
5. 公開ステータスを確認します。

**修正方法:**

変更が公開されていない場合は、**Publish** を選択して開発サンドボックスにプッシュします。テストを再開する前に、変更が伝播するまで約 **30 分**待ちます。

<Warning>XBOX Settings ページで **Save** をクリックしても、変更は公開され**ません**。**Gameplay settings** ページから明示的に公開する必要があります。</Warning>

***

### ✅ 8. PC プラットフォームが有効になっている

PC で開発している場合、タイトルに対して **Windows 10 PC** (およびそれ以降) プラットフォームが有効になっている必要があります。これがないと、サインインはエラー `0x87dd0005 (AM_E_XAST_UNEXPECTED)` で失敗します。

**確認方法:**

1. [Partner Center](https://partner.microsoft.com/dashboard) にアクセスします。
2. 製品を選択します。
3. **XBOX services** > **XBOX Settings** に移動します。
4. **Windows 10 PC** チェックボックスが**オン**になっていることを確認します。最新の Windows バージョンについても同様に行います。

**修正方法:**

1. **Windows 10 PC** チェックボックスをオンにします。
2. **Save** を選択します。
3. **Gameplay settings** に移動し、設定を開発サンドボックスに**公開**します。
4. テストする前に約 **30 分**待ちます。

***

## 診断フローチャート

プリフライトチェックリストで問題が解決しなかった場合は、この段階的なプロセスを使用して根本原因を絞り込みます。ステップ 1 から始めて、分岐をたどってください。

```
┌─────────────────────────────────────────────────────────┐
│                  Still can't sign in?                   │
│         Start here after completing the                 │
│              Preflight Checklist                        │
└───────────────────────┬─────────────────────────────────┘
                        │
                        ▼
        ┌───────────────────────────────┐
        │  STEP 1: Can you sign in to   │
        │  the Xbox App with your       │
        │  test account?                │
        └───────┬───────────────┬───────┘
                │               │
            YES ▼           NO  ▼
    ┌───────────────┐   ┌──────────────────────────────────────────────┐
    │  Sandbox and  │   │  Sandbox or account                          │
    │  account are  │   │  issue. Check:                               │
    │  working.     │   │                                              │
    │  Go to Step 2 │   │  • Is the sandbox ID correct?                │
    │               │   │  • Is the account access to sandbox expired? │
    └───────┬───────┘   │  • Does the account have sandbox access?     │
            │           │  • Are the credentials right?                │
            │           │  • Is the Xbox App up to date?               │
            │           │  • Is the Xbox App licensed?                 │
            │           │                                              │
            │           │  See: Account & Sandbox Errors below         │
            │           └──────────────────────────────────────────────┘
            ▼
┌───────────────────────────────┐
│  STEP 2: Can you sign in to   │
│  a sample project with your   │
│  game's IDs?                  │
└───────┬───────────────┬───────┘
        │               │
    YES ▼           NO  ▼
┌───────────────┐   ┌──────────────────────────────┐
│  Config is    │   │  Configuration issue.        │
│  working.     │   │  Check:                      │
│  Go to Step 3 │   │                              │
│               │   │  • Are the IDs correct in    │
└───────┬───────┘   │    MicrosoftGame.config?     │
        │           │  • Are the gameplay settings │
        │           │    published to the sandbox? │
        │           │  • Is the PC Platform        │
        │           │    enabled?                  │
        │           │  • Is the SCID correct in    │
        │           │    XblInitialize?            │
        │           │                              │
        │           │  See: Configuration          │
        │           │  Errors below                │
        │           └──────────────────────────────┘
        ▼
┌───────────────────────────────┐
│  STEP 3: Game-specific issue  │
│  The sample works but your    │
│  game doesn't.                │
│                               │
│  • Compare the MicrosoftGame  │
│    .config files              │
│  • Compare the sign-in code   │
│  • Check the error code in    │
│     reference table below     │
└───────────────────────────────┘
```

***

## アカウントおよびサンドボックスエラー

XBOX App にサインインでき**なかった**場合 ([診断フローチャート](#diagnostic-flowchart) のステップ 1)、問題はサンドボックスの切り替え、テストアカウント、または XBOX App 自体にあります。

### ユーザーはこのサンドボックスにいません (0x8015DC12)

テストアカウントがサンドボックスへのアクセス権を持っていないか、ゲームの構成がサンドボックスと一致しません。

**一般的な原因と修正方法:**

| 原因                                                  | 修正方法                                                                                                                                                          |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `MicrosoftGame.config` の ID が Partner Center と一致しない | [チェックリスト項目 1](#-1-review_the_sandbox_Id_does_not_have_any_typos) および [チェックリスト項目 2](#-2-your-sandbox-is-correct) を参照                                           |
| テストアカウントがサンドボックスへのアクセス権を持たない                        | Partner Center でテストアカウントを編集し、サンドボックスを追加します                                                                                                                    |
| テストアカウントのサンドボックスへのアクセスが期限切れ                         | Partner Center で有効期限を確認し、新しいアカウントを作成するか、期限を延長します                                                                                                              |
| shared の代わりに isolated サンドボックスを使用している                | Partner Center でサンドボックスのタイプを確認します。isolated を使用する特定の理由がなければ、shared サンドボックスに切り替えます。[Isolated サンドボックスと shared サンドボックス](#isolated-vs-shared-sandboxes) を参照してください。 |

### サンドボックス ID が誤っている

一般的な間違いには次のものがあります。

* 文字の欠落または追加: `XDKS.1` の代わりに `XDKS1`
* 誤ったサンドボックス: ゲームの構成が公開されているサンドボックスと異なるサンドボックスに切り替えている

**修正方法:**

1. `XblPCSandbox /get` を実行し、出力を Partner Center と比較します。
2. Partner Center の正確な値を使用して、`XblPCSandbox <correct sandbox ID>` を再実行します。

### テストアカウントに対して誤ったサンドボックス (Garrison エラー)

アカウントが別のサンドボックスで動作するはずだと示唆するエラーメッセージが表示されたり、サインイン中に XBOX identity service が予期しないエラーを返したりする場合、そのテストアカウントに対して誤ったサンドボックスにサインインしている可能性があります。

**修正方法:**

1. `XblPCSandbox /get` を実行して、PC が設定されているサンドボックスを確認します。
2. Partner Center で、**XBOX services** > **Test accounts** に移動し、テストアカウントがそのサンドボックスへのアクセス権を持っていることを確認します。
3. サンドボックスが一致しない場合は、正しいものに切り替えます: `XblPCSandbox <correct sandbox ID>`

### XBOX App ライセンスエラー (0x803F8001)

以前に RETAIL で開いたことがない場合、XBOX App の起動に失敗することがあります。

**修正方法:**

1. RETAIL に切り替えます: `XblPCSandbox /retail` (または `XblPCSandbox RETAIL`)
2. XBOX App を開いて完全に起動させます。
3. 開発サンドボックスに戻します: `XblPCSandbox <your sandbox ID>`

### XBOX App が見つからない

XBOX App は Microsoft Store で入手できますが、**RETAIL サンドボックスにいるときのみ**です。見つからない場合:

1. RETAIL に切り替えます: `XblPCSandbox /retail` (または `XblPCSandbox RETAIL`)
2. Microsoft Store で "XBOX" を検索し、インストールします。
3. サンドボックスに戻します。

***

## 構成エラー

XBOX App にはサインイン**できる**が、ゲーム内またはサンプルプロジェクト内でサインインでき**ない**場合 ([診断フローチャート](#diagnostic-flowchart) のステップ 2)、問題はゲームの XBOX services 構成にあります。

### PC プラットフォームが有効になっていない (0x87dd0005、AM\_E\_XAST\_UNEXPECTED)

このエラーは、Windows 10 PC プラットフォームが Partner Center で追加されていないことを意味します。それ以降のバージョンについても確認してください。

**修正方法:**

1. Partner Center で、製品 > **XBOX services** > **XBOX Settings** に移動します。
2. **Windows 10 PC** チェックボックスをオンにします。
3. **Save** を選択します。
4. **Gameplay settings** に移動し、設定を開発サンドボックスに**公開**します。
5. **30 分**待ってから、再度サインインを試みます。

<Warning>XBOX Settings ページで **Save** をクリックしても、変更は公開され**ません**。サインインが動作するためには、**Gameplay settings** ページから明示的に公開する必要があります。</Warning>

### XBOX services 構成が公開されていない

Partner Center で保存された変更は、開発サンドボックスに公開されるまでは有効になりません。

**修正方法:**

1. Partner Center で **XBOX services** > **Gameplay settings** に移動します。
2. 開発サンドボックスのタブを選択します。
3. **Publish** を選択します。
4. 変更が伝播するまで約 **30 分**待ちます。

### MicrosoftGame.config 内の ID が誤っている

サインインエラーの一般的な原因は、`MicrosoftGame.config` 内の 1 つまたは複数の値が一致していないことです。

**修正方法:**

[MicrosoftGame.config Editor](/build/core-features/common/game-config/MicrosoftGameConfig-Editor) の **Store Association Wizard** を使用してゲームをリンクし、正しい値を自動入力します。または、[チェックリスト項目 1](#-1-your-ids-match-partner-center) を使用して、各値を Partner Center と手動で照合します。

### XblInitialize 内の SCID が誤っている

SCID は `MicrosoftGame.config` には**ありません**。これは [XblInitialize](/reference/live/xsapi-c/xbox_live_global_c/functions/xblinitialize) にパラメーターとして渡されます。Partner Center (**XBOX services** > **XBOX Settings**) から正しい SCID を渡していることを確認してください。

### Isolated サンドボックスと shared サンドボックス

isolated サンドボックスを使用する特定の理由がない限り、**shared** サンドボックスを使用してください。サンドボックスのタイプは Partner Center で確認できます。isolated サンドボックスには、サインインの失敗を引き起こす可能性のある追加の制限があります。

***

## ゲーム固有のトラブルシューティング

XBOX App のサインインが動作**し**、サンプルプロジェクトがゲームの ID で動作するが、それでもゲームがサインインできない場合 ([診断フローチャート](#diagnostic-flowchart) のステップ 3)、問題はゲームのコードまたは構成に固有のものです。

### MicrosoftGame.config ファイルを比較する

ゲームの `MicrosoftGame.config` と動作するサンプルとの差分をとってください。追加または欠落しているフィールド、書式の違い、または誤った値を探します。

### サインインコードを比較する

ゲームのサインイン実装をサンプルのコードと比較します。`XUserAddAsync` の呼び出し方 (オプション、コールバック、エラー処理) の違いを探します。

### デフォルトユーザーがない (0x89245106、E\_GAMEUSER\_NO\_DEFAULT\_USER)

このエラーは、現在サインインしているデフォルトユーザーがいないことを意味します。

**原因:** `AddDefaultUserSilently` オプションを指定して `XUserAddAsync` を呼び出しましたが、現在サインインしているユーザーがいません。

**修正方法:**

詳細については、[`XUserAddAsync`](/reference/system/xuser/functions/xuseraddasync) および [AdvancedUserModel](/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-advancedusermodel) を参照してください。

***

## 追加のトラブルシューティング

### XBOX services で障害が発生している

他のすべてのオプションを使い果たしている場合は、XBOX services で障害が発生していないか確認してください。

* [XBOX Status ページ](https://support.xbox.com/xbox-live-status)

> \[!IMPORTANT]
> **既知の制限 (GDK 26.04):** SSH セッション経由で実行した場合、`XblPCSandbox` はサンドボックスの切り替えに失敗します。代わりに、ローカルセッションから `XblPCSandbox` を実行してください。

***

## エラーコードクイックリファレンス

| エラーコード       | 名前                           | 考えられる原因                                                               | 修正方法                                                                                                                                                                                                             |
| ------------ | ---------------------------- | --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `0x8015DC12` | ユーザーがサンドボックスにいない             | ID の不一致、サンドボックスアクセスなし、テストアカウントのサンドボックスへのアクセス期限切れ、または isolated サンドボックス | [チェックリスト](#preflight-checklist) を参照。ID、アカウントアクセス、サンドボックスタイプを確認                                                                                                                                                   |
| `0x87dd0005` | `AM_E_XAST_UNEXPECTED`       | Partner Center で PC プラットフォームが有効になっていない                                | XBOX Settings で **Windows 10 (およびそれ以降) PC** を有効にし、サンドボックスに**公開**し、30 分待つ                                                                                                                                         |
| `0x89245106` | `E_GAMEUSER_NO_DEFAULT_USER` | デフォルトユーザーがサインインしていない。`XUserAddAsync(AddDefaultUserSilently)` を呼び出した   | 対処方法の詳細については、[`XUserAddAsync`](/reference/system/xuser/functions/xuseraddasync) および [AdvancedUserModel](/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-advancedusermodel) を参照してください。 |
| `0x803F8001` | ライセンスエラー                     | XBOX App が以前に RETAIL で起動されていない                                        | RETAIL に切り替え、XBOX App を起動、dev サンドボックスに戻す                                                                                                                                                                         |
| `0x80004005` | 汎用サインイン失敗                    | サンドボックスまたはアカウントの構成ミス。サービス側の問題を示すこともあります                               | [プリフライトチェックリスト](#preflight-checklist) を実行。サンドボックス ID、テストアカウントアクセス、およびアカウントの有効期限を確認します。問題が続く場合は、PC を再起動し、サンドボックスを再切り替えしてみてください。                                                                                   |

<Note>
  ここに掲載されていないエラーコードが表示された場合は、Feedback Hub を通じて問題を送信してください。

  xblPcSandbox /feedback を使用してバグを送信してください。

  または、Feedback Hub から直接行う場合は、**Category: Gaming and XBOX** および **Area: Developer Tools** を選択します。
</Note>

***

## 関連項目

* [サンドボックスの概要](/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox)
* [高度なサンドボックスの概念的概要](/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes)
* [テストアカウント](/services/xbox-services/develop/test-accounts/live-test-accounts)
* [XBOX services 構成の概要](/services/xbox-services/fundamentals/portal-config/live-portal-config-overview)
* [MicrosoftGame.config の概要](/build/core-features/common/game-config/MicrosoftGameConfig-Overview)
* [XblPCSandbox.exe リファレンス](/tools/tools-services/live-pc-sandbox-switcher)


## Related topics

- [XBOX services サンドボックスの概要](/ja-jp/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)
- [XBOX services のサインインのトラブルシューティング](/ja-jp/services/xbox-services/fundamentals/identity/auth/live-troubleshooting-sign-in.md)
- [トラブルシューティング](/ja-jp/services/xbox-services/develop/troubleshooting/index.md)
- [PC サンドボックス スイッチャー (XblPCSandbox.exe)](/ja-jp/tools/tools-services/live-pc-sandbox-switcher.md)
- [XStore 開発のトラブルシューティング](/ja-jp/publishing/xstore-commerce/xstore-troubleshooting.md)
