次の方法で共有

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

  • [アーティクル]

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

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

エラーがない場合、無効な招待/アクティビティ参加 UI は、タイトルまたはサービスの構成が正しくないことが原因で発生するのが最も一般的です。

最適なトラブルシューティング方法は、次の手順に従う方法です:

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

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

  3. MicrosoftGame.config ファイル内のすべての ID が正しく設定されていることを確認します。
    MicrosoftGame.config には、タイトルの正しい titleID、SCID、ID 情報がパートナー センター構成と一致する必要があります ([ゲームのセットアップ] で表示されます)。

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

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

    • MPSD セッションには、参加制限は含まれていません。 joinRestriction プロパティが follow/local に設定されていないことを確認して、非フォロワーの参加を防止したり、参加を完全に制限したりします。

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

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

     /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 セッションのクロスプレイ構成が正しくない可能性があります。 既定では、Xbox Series X|S デバイス ファミリが設定されていない場合、Xbox One デバイスはクロスプレイをサポートします。

    • タイトルが Xbox One 以外の追加プラットフォームでリリースされたら、パートナー センターの [Xbox 設定]/[デバイス ファミリ] リストで、関連するすべてのプラットフォームが有効になっていることを確認します。

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

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

     /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. パートナー センターでタイトルのデバイスの可用性を確認します。
    パートナー センターの [ゲームのセットアップ]/[デバイス ファミリの可用性] 設定では、タイトルの機能と可用性を制限できます。 関連するすべてのプラットフォームが有効になっていることを確認します。 既定では、Xbox Series X|S デバイス ファミリが設定されていない場合、Xbox One デバイスはクロスプレイをサポートします。

  8. タイトルが "プライベート対象ユーザー" グループに限定されていないことをご確認ください。
    タイトルの表示を "プライベート対象ユーザー" (パートナー センターの '価格と可用性'/'可視性') に制限すると、タイトルのアクセスとサービスの機能が制限される可能性があります。 これが有効になっている場合は、本体もユーザーも "プライベート対象ユーザー" グループに属していることを確認します。

  9. PC タイトルの MicrosoftGame.config ファイルに MultiplayerProtocol 設定が存在することを確認します。
    Windows タイトルが Xbox Game Bar UI を正しく統合できるようにするには、MultiplayerProtocol 設定を true に設定する必要があります。 詳細については、「MicrosoftGame.config の概要」を参照してください。

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