> ## 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 邀請與活動疑難排解指南

> 透過檢查工作階段狀態、沙箱與遊戲識別碼、MicrosoftGame.config 以及範本設定，針對已停用的 MPSD 邀請與活動加入 UI 進行疑難排解。

下列指南可作為起點，協助遊戲針對使用 MPSD 的邀請與活動功能進行疑難排解。

使用此 MPSD 功能並遇到問題的遊戲開發人員，應先確定所使用的 MPSD 工作階段有效，且 MPSD 呼叫沒有其他 API 錯誤或 HTTP 錯誤。

在沒有錯誤的情況下，邀請/活動加入 UI 被停用最常見的原因是遊戲或服務設定不正確。

最佳的疑難排解方法是依照下列步驟執行：

1. 確認 MPSD 工作階段未關閉、未鎖定或未滿。
   已關閉 (`"closed": true`) 或已滿的工作階段會停用邀請與加入。已鎖定的 MPSD 工作階段 (`"locked": true`) 只允許先前的工作階段成員重新加入。

2. 確認測試中所有遊戲執行個體的沙箱與 titleID。
   所有遊戲執行個體都必須位於相同的沙箱中、使用相同的 titleID (以及 SCID)，且 MPSD 工作階段範本必須在此沙箱中設定。

3. 確認 MicrosoftGame.config 檔案中的所有識別碼都已正確設定。
   MicrosoftGame.config 必須包含正確的 titleID、SCID，且身分識別資訊必須符合您遊戲在 Partner Center 中的設定 (可在「Game Setup」中查看)。

4. 確認已為您的情境設定正確的 MPSD 工作階段設定。

   * MPSD 工作階段中已定義 inviteProtocol 常數。遊戲必須設定 `"inviteProtocol": "game"` 常數，邀請行為才會正確。

   * MPSD 工作階段不包含任何加入限制。請確認 joinRestriction 屬性未設為 followed/local，以免阻止非追蹤者加入或完全限制加入。

   * MPSD 工作階段的 userAuthorizationStyle 屬性已正確設定。對於非主機裝置的 MPSD 工作階段，必須啟用 userAuthorizationStyle 屬性，而且還需要 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. 確認您的遊戲未限制為私人對象群組。
   將遊戲可見度限制為私人對象 (Partner Center 中的「Pricing and availability」/「Visibility」) 可能會限制遊戲存取與服務功能。如果已啟用此設定，請確定兩部主機/使用者都屬於私人對象群組。

9. 確認 PC 遊戲的 MicrosoftGame.config 檔案中有 MultiplayerProtocol 設定。
   Windows 遊戲必須將 MultiplayerProtocol 設定設為 true，才能正確整合 XBOX Game Bar UI。如需詳細資訊，請參閱 [MicrosoftGame.config 概觀](/zh-TW/build/core-features/common/game-config/MicrosoftGameConfig-Overview)。

10. 確認您沒有意外混用 MPA 與 MPSD 服務呼叫。
    MPSD 與 MPA 服務無法同時使用。這麼做會導致非預期的活動/加入/邀請行為。遊戲只能選擇其中一項服務。


## Related topics

- [MPA 邀請和活動疑難排解指南](/zh-TW/services/xbox-services/multiplayer/mpa/concepts/live-mpa-troubleshooting.md)
- [多人遊戲工作階段目錄 (MPSD) 概念](/zh-TW/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-concepts-nav.md)
- [XBOX PC 遠端工具常見問題集與疑難排解指南](/zh-TW/tools/tools-pc/xbox-pc-remote-tools/faq.md)
- [概念](/zh-TW/services/xbox-services/multiplayer/mpsd/concepts/index.md)
- [多人遊戲活動 (MPA) 概念](/zh-TW/services/xbox-services/multiplayer/mpa/concepts/live-mpa-concepts-nav.md)