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

# MPA 招待およびアクティビティのトラブルシューティング ガイド

> 参加制限、クロスプレイ フラグ、サンドボックス、タイトル ID、Partner Center 設定を確認して、XBOX Multiplayer Activity の招待およびアクティビティの問題をトラブルシューティングします。

以下のガイドは、MPA サービスを使用する招待およびアクティビティ機能のトラブルシューティングを支援するタイトルの出発点です。

タイトル開発者はまず、MPA API 呼び出しに対するエラーや HTTP エラーが存在しないことを確認する必要があります。エラーがない場合、招待/アクティビティの参加 UI が無効になる最も一般的な原因は、タイトルまたはサービスの構成が正しくないことです。

その次に、以下の手順に従うのがベストなトラブルシューティング アプローチです。

1. 現在のアクティビティに制限的な `JoinRestriction` がないことを確認します。`Followed` または `InviteOnly` に設定された値は、参加可能性を制限します。

2. アクティビティの `platform` プロパティまたは `allowCrossPlatformJoin` 招待フラグが、クロスプレイを制限していないことを確認します。
   特定の `platform` 値 (例: `XboxOne`) を設定すると、アクティビティのプラットフォーム UI 参加および招待がそのプラットフォームに制限されます。`allowCrossPlatformJoin` 招待フラグを `false` に設定すると、platform フィールドに現在のプラットフォームが自動的に設定されます。招待はそのプラットフォームのプレイヤーだけが受け取ります。

3. テスト中のすべてのタイトル インスタンスのサンドボックスとタイトル ID を確認します。
   すべてのタイトル インスタンスは同一のサンドボックスに存在し、同じタイトル ID (および SCID) を使用する必要があります。また、このサンドボックスで MPSD セッション テンプレートが構成されている必要があります。

4. MicrosoftGame.config ファイル内のすべての ID が正しく設定されていることを確認します。
   MicrosoftGame.config には正しいタイトル ID、SCID、およびタイトルの Partner Center 構成 (「Game Setup」で表示可能) に一致する Identity 情報が含まれている必要があります。

5. Partner Center 内のタイトルのデバイスの可用性を確認します。
   Partner Center の「Game Setup」/「Device family availability」設定は、タイトルの機能や可用性を制限する可能性があります。関連するすべてのプラットフォームが有効になっていることを確認してください。既定では、XBOX Series X|S デバイス ファミリが設定されていない場合、XBOX One デバイスがクロスプレイをサポートします。

6. タイトルがプライベート オーディエンス グループに制限されていないことを確認します。
   タイトルの可視性をプライベート オーディエンスに制限する (Partner Center の「Pricing and availability」/「Visibility」) と、タイトル アクセスとサービス機能が制限される可能性があります。たとえば、サインインしているユーザーがプライベート オーディエンスに含まれていない場合、返される最近のプレイヤー情報には適切なタイトル名が含まれません。これが有効な場合、両方のコンソール/ユーザーがプライベート オーディエンス グループに含まれていることを確認してください。

7. PC タイトルの場合、MicrosoftGame.config ファイルに MultiplayerProtocol 設定が存在することを確認します。
   MultiplayerProtocol 設定は、XBOX Game Bar UI との適切な統合を有効にするために、Windows タイトルでは true に設定する必要があります。詳細については、[MicrosoftGame.config の概要](/build/core-features/common/game-config/MicrosoftGameConfig-Overview) を参照してください。

8. MPA と MPSD のサービス呼び出しを誤って混在させていないことを確認します。
   MPSD と MPA サービスは同時に使用できません。これを行うと、アクティビティ/参加/招待で予期しない動作が発生します。タイトルは 1 つのサービスのみを選択する必要があります。

9. プラットフォーム UI は、満員のアクティビティ (`currentPlayers` が `maxPlayers` に等しい) を無効にしません。これは主に競合状態を回避するためですが、`currentPlayers` も省略可能なフィールドです。満員時に参加可能性を制限したい場合は、アクティビティを削除するか、プレイヤーが参加して満員だった場合のエラー ケースを処理する必要があります。ゲームを通じて処理することが既に必要であるため、エラー メッセージの表示が推奨されます。


## Related topics

- [MPSD の招待とアクティビティのトラブルシューティングガイド](/ja-jp/services/xbox-services/multiplayer/mpsd/concepts/live-multiplayer-invite-troubleshooting.md)
- [XBOX PC Remote Tools の FAQ とトラブルシューティング ガイド](/ja-jp/tools/tools-pc/xbox-pc-remote-tools/faq.md)
- [サインインおよびサンドボックスエラーのトラブルシューティング](/ja-jp/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md)
- [Multiplayer Activity (MPA) の概念](/ja-jp/services/xbox-services/multiplayer/mpa/concepts/live-mpa-concepts-nav.md)
- [概念](/ja-jp/services/xbox-services/multiplayer/mpa/concepts/index.md)
