MPSD 邀請與活動疑難排解指南

下列指南可作為起點，協助遊戲針對使用 MPSD 的邀請與活動功能進行疑難排解。使用此 MPSD 功能並遇到問題的遊戲開發人員，應先確定所使用的 MPSD 工作階段有效，且 MPSD 呼叫沒有其他 API 錯誤或 HTTP 錯誤。在沒有錯誤的情況下，邀請/活動加入 UI 被停用最常見的原因是遊戲或服務設定不正確。最佳的疑難排解方法是依照下列步驟執行：

確認 MPSD 工作階段未關閉、未鎖定或未滿。已關閉 ("closed": true) 或已滿的工作階段會停用邀請與加入。已鎖定的 MPSD 工作階段 ("locked": true) 只允許先前的工作階段成員重新加入。
確認測試中所有遊戲執行個體的沙箱與 titleID。所有遊戲執行個體都必須位於相同的沙箱中、使用相同的 titleID (以及 SCID)，且 MPSD 工作階段範本必須在此沙箱中設定。
確認 MicrosoftGame.config 檔案中的所有識別碼都已正確設定。 MicrosoftGame.config 必須包含正確的 titleID、SCID，且身分識別資訊必須符合您遊戲在 Partner Center 中的設定 (可在「Game Setup」中查看)。
確認已為您的情境設定正確的 MPSD 工作階段設定。
- MPSD 工作階段中已定義 inviteProtocol 常數。遊戲必須設定 "inviteProtocol": "game" 常數，邀請行為才會正確。
- MPSD 工作階段不包含任何加入限制。請確認 joinRestriction 屬性未設為 followed/local，以免阻止非追蹤者加入或完全限制加入。
- MPSD 工作階段的 userAuthorizationStyle 屬性已正確設定。對於非主機裝置的 MPSD 工作階段，必須啟用 userAuthorizationStyle 屬性，而且還需要 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.

確認邀請/加入問題不僅限於跨裝置情境。如果邀請/加入問題只發生在不同的主機類型之間 (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 範本設定如下：

     /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)

確認工作階段的擁有權行為未造成邀請限制。設定了 hasOwners 與工作階段擁有者的工作階段，也需要將 allowNonOwnerInviteHandles 設為 true，非擁有者才能傳送邀請。請根據所需的行為設定此常數。
確認您的遊戲在 Partner Center 中的裝置可用性。 Partner Center 中的「Game Setup」/「Device family availability」設定可能會限制您遊戲的功能與可用性。請確定已啟用所有相關平台。根據預設，如果未設定 XBOX Series X|S 裝置系列，XBOX One 裝置會支援跨平台遊玩。
確認您的遊戲未限制為私人對象群組。將遊戲可見度限制為私人對象 (Partner Center 中的「Pricing and availability」/「Visibility」) 可能會限制遊戲存取與服務功能。如果已啟用此設定，請確定兩部主機/使用者都屬於私人對象群組。
確認 PC 遊戲的 MicrosoftGame.config 檔案中有 MultiplayerProtocol 設定。 Windows 遊戲必須將 MultiplayerProtocol 設定設為 true，才能正確整合 XBOX Game Bar UI。如需詳細資訊，請參閱 MicrosoftGame.config 概觀。
確認您沒有意外混用 MPA 與 MPSD 服務呼叫。 MPSD 與 MPA 服務無法同時使用。這麼做會導致非預期的活動/加入/邀請行為。遊戲只能選擇其中一項服務。

XBOX Services

PlayFab