この記事の内容
プリフライトチェックリスト
特定のエラーを調査する前に、このチェックリストを実行してください。ほとんどのサインインの問題は、これらの項目のいずれかが誤って構成されていることが原因です。以下のすべてを確認してから、下の診断フローチャートおよびエラーセクションに進んでください。XblPCSandbox.exe ツールがすでにインストールされていることが重要です。
入手方法の詳細については、サンドボックスの概要 を参照してください。
環境チェック
これらの項目は、XBOX App を含む XBOX services にサインインする能力に影響します。最初にこれらを確認してください。✅ 1. サンドボックス ID に誤字がないか確認する
サンドボックス ID が正しく入力されていることを確認してください。 確認方法:✅ 2. サンドボックスが正しい
PC は、ゲームの XBOX services 構成が公開されているのと同じ開発サンドボックスに設定されている必要があります。 確認方法:✅ 3. テストアカウントが有効である
テストアカウントは、いくつかの理由で無効になる可能性があります。以下のすべてを確認してください。アカウントのサンドボックスへのアクセスが期限切れになっていない
テストアカウントのサンドボックスへのアクセスには有効期限があります。サンドボックスへのアクセスが期限切れになったアカウントは、サンドボックスにサインインできません。 確認方法:- Partner Center にアクセスします。
- Apps and Games を選択します。
- XBOX Test accounts を選択します (または テストアカウント管理 にアクセスします)。
- テストアカウントを見つけて、Access Expires および Status 列を確認します。
アカウントがサンドボックスにアクセスできる
テストアカウントを作成する際、特定のサンドボックスへのアクセスを許可する必要があります。 確認方法:- Partner Center で、XBOX services > Test accounts に移動します。
- テストアカウントを選択します。
- 開発サンドボックスがアカウントのサンドボックスアクセスの下に一覧表示されていることを確認します。
認証情報が正しい
テストアカウントの正しいメールアドレスとパスワードを使用していることを確認してください。テストアカウントのメールアドレスは、通常@xboxtest.com で終わります。
✅ 4. XBOX ゲーミングコンポーネントが最新である
XBOX services は、PC 上の XBOX App と Gaming Services コンポーネントに依存しています。いずれかの古いバージョンは、予期しないサインインの失敗を引き起こす可能性があります。 確認方法:- Game Repair Tool について提供されている情報に従います。
✅ 5. PC を再起動する
サインインに必要なバックグラウンドサービス (XBOX Live Auth Manager や Gaming Services など) が不正な状態になることがあります。上記の手順ではキャッチできない一時的な問題を、PC を再起動することで解決できる場合があります。 再起動する前に、Feedback Hub を通じてバグを送信することが重要です。これにより、将来のリリースで追跡および対処できるようになります。 これは、次のコマンドを使用して行うことができます。プロジェクトチェック
これらの項目は、特にゲームからのサインインに影響します。XBOX App にサインインできるがゲームからサインインできない場合は、ここから始めます。✅ 6. ID が Partner Center と一致している
MicrosoftGame.config の ID は、Partner Center の値と正確に一致する必要があります。1 つでも値が一致していないと、サインインできません。
確認方法:
MicrosoftGame.config を開き、これらの値を Partner Center と比較します。
さらに、SCID (Service Configuration ID) を確認します。SCID は
MicrosoftGame.config にはありません。これは XblInitialize メソッドにパラメーターとして渡されます。Partner Center の XBOX services > XBOX Settings で確認できます。
✅ 7. XBOX services 構成がサンドボックスに公開されている
Partner Center で変更を保存しても、開発サンドボックスに公開するまでは有効になりません。 確認方法:- Partner Center にアクセスします。
- 製品を選択します。
- XBOX services > Gameplay settings に移動します。
- 開発サンドボックスのタブを選択します。
- 公開ステータスを確認します。
✅ 8. PC プラットフォームが有効になっている
PC で開発している場合、タイトルに対して Windows 10 PC (およびそれ以降) プラットフォームが有効になっている必要があります。これがないと、サインインはエラー0x87dd0005 (AM_E_XAST_UNEXPECTED) で失敗します。
確認方法:
- Partner Center にアクセスします。
- 製品を選択します。
- XBOX services > XBOX Settings に移動します。
- Windows 10 PC チェックボックスがオンになっていることを確認します。最新の Windows バージョンについても同様に行います。
- Windows 10 PC チェックボックスをオンにします。
- Save を選択します。
- Gameplay settings に移動し、設定を開発サンドボックスに公開します。
- テストする前に約 30 分待ちます。
診断フローチャート
プリフライトチェックリストで問題が解決しなかった場合は、この段階的なプロセスを使用して根本原因を絞り込みます。ステップ 1 から始めて、分岐をたどってください。アカウントおよびサンドボックスエラー
XBOX App にサインインできなかった場合 (診断フローチャート のステップ 1)、問題はサンドボックスの切り替え、テストアカウント、または XBOX App 自体にあります。ユーザーはこのサンドボックスにいません (0x8015DC12)
テストアカウントがサンドボックスへのアクセス権を持っていないか、ゲームの構成がサンドボックスと一致しません。 一般的な原因と修正方法:サンドボックス ID が誤っている
一般的な間違いには次のものがあります。- 文字の欠落または追加:
XDKS.1の代わりにXDKS1 - 誤ったサンドボックス: ゲームの構成が公開されているサンドボックスと異なるサンドボックスに切り替えている
XblPCSandbox /getを実行し、出力を Partner Center と比較します。- Partner Center の正確な値を使用して、
XblPCSandbox <correct sandbox ID>を再実行します。
テストアカウントに対して誤ったサンドボックス (Garrison エラー)
アカウントが別のサンドボックスで動作するはずだと示唆するエラーメッセージが表示されたり、サインイン中に XBOX identity service が予期しないエラーを返したりする場合、そのテストアカウントに対して誤ったサンドボックスにサインインしている可能性があります。 修正方法:XblPCSandbox /getを実行して、PC が設定されているサンドボックスを確認します。- Partner Center で、XBOX services > Test accounts に移動し、テストアカウントがそのサンドボックスへのアクセス権を持っていることを確認します。
- サンドボックスが一致しない場合は、正しいものに切り替えます:
XblPCSandbox <correct sandbox ID>
XBOX App ライセンスエラー (0x803F8001)
以前に RETAIL で開いたことがない場合、XBOX App の起動に失敗することがあります。 修正方法:- RETAIL に切り替えます:
XblPCSandbox /retail(またはXblPCSandbox RETAIL) - XBOX App を開いて完全に起動させます。
- 開発サンドボックスに戻します:
XblPCSandbox <your sandbox ID>
XBOX App が見つからない
XBOX App は Microsoft Store で入手できますが、RETAIL サンドボックスにいるときのみです。見つからない場合:- RETAIL に切り替えます:
XblPCSandbox /retail(またはXblPCSandbox RETAIL) - Microsoft Store で “XBOX” を検索し、インストールします。
- サンドボックスに戻します。
構成エラー
XBOX App にはサインインできるが、ゲーム内またはサンプルプロジェクト内でサインインできない場合 (診断フローチャート のステップ 2)、問題はゲームの XBOX services 構成にあります。PC プラットフォームが有効になっていない (0x87dd0005、AM_E_XAST_UNEXPECTED)
このエラーは、Windows 10 PC プラットフォームが Partner Center で追加されていないことを意味します。それ以降のバージョンについても確認してください。 修正方法:- Partner Center で、製品 > XBOX services > XBOX Settings に移動します。
- Windows 10 PC チェックボックスをオンにします。
- Save を選択します。
- Gameplay settings に移動し、設定を開発サンドボックスに公開します。
- 30 分待ってから、再度サインインを試みます。
XBOX services 構成が公開されていない
Partner Center で保存された変更は、開発サンドボックスに公開されるまでは有効になりません。 修正方法:- Partner Center で XBOX services > Gameplay settings に移動します。
- 開発サンドボックスのタブを選択します。
- Publish を選択します。
- 変更が伝播するまで約 30 分待ちます。
MicrosoftGame.config 内の ID が誤っている
サインインエラーの一般的な原因は、MicrosoftGame.config 内の 1 つまたは複数の値が一致していないことです。
修正方法:
MicrosoftGame.config Editor の Store Association Wizard を使用してゲームをリンクし、正しい値を自動入力します。または、チェックリスト項目 1 を使用して、各値を Partner Center と手動で照合します。
XblInitialize 内の SCID が誤っている
SCID はMicrosoftGame.config にはありません。これは XblInitialize にパラメーターとして渡されます。Partner Center (XBOX services > XBOX Settings) から正しい SCID を渡していることを確認してください。
Isolated サンドボックスと shared サンドボックス
isolated サンドボックスを使用する特定の理由がない限り、shared サンドボックスを使用してください。サンドボックスのタイプは Partner Center で確認できます。isolated サンドボックスには、サインインの失敗を引き起こす可能性のある追加の制限があります。ゲーム固有のトラブルシューティング
XBOX App のサインインが動作し、サンプルプロジェクトがゲームの ID で動作するが、それでもゲームがサインインできない場合 (診断フローチャート のステップ 3)、問題はゲームのコードまたは構成に固有のものです。MicrosoftGame.config ファイルを比較する
ゲームのMicrosoftGame.config と動作するサンプルとの差分をとってください。追加または欠落しているフィールド、書式の違い、または誤った値を探します。
サインインコードを比較する
ゲームのサインイン実装をサンプルのコードと比較します。XUserAddAsync の呼び出し方 (オプション、コールバック、エラー処理) の違いを探します。
デフォルトユーザーがない (0x89245106、E_GAMEUSER_NO_DEFAULT_USER)
このエラーは、現在サインインしているデフォルトユーザーがいないことを意味します。 原因:AddDefaultUserSilently オプションを指定して XUserAddAsync を呼び出しましたが、現在サインインしているユーザーがいません。
修正方法:
詳細については、XUserAddAsync および AdvancedUserModel を参照してください。
追加のトラブルシューティング
XBOX services で障害が発生している
他のすべてのオプションを使い果たしている場合は、XBOX services で障害が発生していないか確認してください。[!IMPORTANT] 既知の制限 (GDK 26.04): SSH セッション経由で実行した場合、XblPCSandboxはサンドボックスの切り替えに失敗します。代わりに、ローカルセッションからXblPCSandboxを実行してください。
エラーコードクイックリファレンス
ここに掲載されていないエラーコードが表示された場合は、Feedback Hub を通じて問題を送信してください。xblPcSandbox /feedback を使用してバグを送信してください。または、Feedback Hub から直接行う場合は、Category: Gaming and XBOX および Area: Developer Tools を選択します。