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

# MPSD の招待とアクティビティのトラブルシューティングガイド

> セッション状態、サンドボックスとタイトル ID、MicrosoftGame.config、およびテンプレート設定を確認して、無効化された MPSD の招待およびアクティビティ参加 UI をトラブルシューティングします。

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

この MPSD 機能を使用しているタイトル開発者が問題に遭遇した場合、まず、使用している MPSD セッションが有効であり、MPSD 呼び出しに関する他の API エラーや HTTP エラーが存在しないことを確認する必要があります。

エラーがないにもかかわらず招待/アクティビティ参加 UI が無効化されている場合、最も一般的な原因はタイトルまたはサービス構成の誤りです。

その後のトラブルシューティングとして最適なアプローチは、以下の手順に従うことです。

1. MPSD セッションが closed、locked、または満員でないことを確認します。
   closed (`"closed": true`) または満員のセッションでは、招待と参加は無効化されます。ロックされた MPSD セッション (`"locked": true`) では、以前のセッションメンバーによる再参加のみが許可されます。

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

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

4. シナリオに適した MPSD セッション構成が整っていることを確認します。

   * inviteProtocol 定数が MPSD セッションで定義されていること。タイトルは正しい招待動作のために `"inviteProtocol": "game"` 定数を設定する必要があります。

   * MPSD セッションに参加制限が含まれていないこと。joinRestriction プロパティが followed/local に設定されていないことを確認し、フォロワーでないプレイヤーの参加を防止したり、参加を完全に制限したりしないようにします。

   * MPSD セッションの userAuthorizationStyle プロパティが正しく設定されていること。userAuthorizationStyle プロパティは、非コンソールデバイスの MPSD セッションで有効にする必要があり、また joinRestriction ('local' または 'followed' のいずれか) も必要です。これは任意のプレイヤーによる参加を防止するためのシステム制限であり、削除することはできません。

   推奨される MPSD テンプレート構成は次のとおりです。

```json theme={null}
     /Constants/System/Capabilities:
         "inviteProtocol" : "game"
         "userAuthorizationStyle": true   (required for non-console devices)
     /Properties/System:
         "joinRestriction" : "none"   (console only) - "followed" (non-console devices) will allow Joins as well as invites. - "local" invite only, no joins allowed.
```

5. 招待/参加の問題がクロスデバイスシナリオに限定されていないことを確認します。
   招待/参加の問題が、異なるコンソールタイプ (XBOX Series X|S、XBOX One) 間、またはコンソール/PC 間でのみ発生する場合、タイトルまたは MPSD セッションの crossPlay 構成が正しくない可能性があります。デフォルトでは、XBOX Series X|S デバイスファミリが設定されていない場合、XBOX One デバイスはクロスプレイをサポートします。

   * タイトルが XBOX One 以外の追加プラットフォームでリリースされた後、関連するすべてのプラットフォームが Partner Center の 'XBOX Settings'/'Device families' リストで有効になっていることを確認します。

   * クロスプレイの MPSD セッション機能が有効になっていること (`"crossPlay": true`) を確認します。

   推奨される MPSD テンプレート構成は次のとおりです。

```json theme={null}
     /Constants/System/Capabilities:
         "crossPlay" : "true"   if you want to support crossPlay between supported deviceTypes (Xbox One as the only device in Partner Center default supports Xbox Series X|S)
```

6. セッションの所有権動作が招待制限を引き起こしていないことを確認します。
   hasOwners とセッションオーナーが設定されているセッションでは、オーナー以外が招待を送信できるようにするために、allowNonOwnerInviteHandles も true に設定する必要があります。目的の動作に応じてこの定数を設定してください。

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

8. タイトルが Private Audience グループに限定されていないことを確認します。
   タイトルの可視性を Private Audiences ('Pricing and availability'/'Visibility' in Partner Center) に制限すると、タイトルへのアクセスとサービス機能が制限される可能性があります。これが有効になっている場合、両方のコンソール/ユーザーが Private Audience グループの一員であることを確認します。

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

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


## Related topics

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