跳轉到主要內容
下列指南是協助遊戲使用 MPA 服務對邀請和活動功能進行疑難排解的起點。 遊戲開發人員應先確保 MPA API 呼叫沒有任何錯誤或 HTTP 錯誤。在沒有錯誤的情況下，邀請/活動加入 UI 被停用最常見的原因是遊戲或服務設定不正確。 最佳的疑難排解方法是依照下列步驟進行：
  1. 確認目前的活動沒有限制性的 JoinRestriction，設定為 Followed 或 InviteOnly 的值會限制可加入性。
  2. 確認活動的 platform 屬性或 allowCrossPlatformJoin 邀請旗標沒有限制跨平台遊玩。 設定特定的 platform 值 (例如 XboxOne) 會將活動平台 UI 加入和邀請限制為該平台。將 allowCrossPlatformJoin 邀請旗標設定為 false，會自動以目前的平台填入平台欄位。邀請只會由該平台上的玩家接收。
  3. 確認測試中所有遊戲執行個體的沙箱和 titleID。 所有遊戲執行個體都必須位於相同的沙箱中、使用相同的 titleID (和 SCID)，且 MPSD 工作階段範本需要在此沙箱中設定。
  4. 確認 MicrosoftGame.config 檔案中的所有識別碼都已正確設定。 MicrosoftGame.config 必須包含正確的 titleID、SCID，且身分識別資訊與您遊戲的 Partner Center 設定 (可在 ‘Game Setup’ 中看到) 相符。
  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 設定。 Windows 遊戲必須將 MultiplayerProtocol 設定設為 true，才能啟用與 XBOX Game Bar UI 的正確整合。如需詳細資料，請參閱 MicrosoftGame.config 概觀。
  8. 確認您沒有意外混用 MPA 和 MPSD 服務呼叫。 MPSD 和 MPA 服務無法同時使用。這麼做會導致非預期的活動/加入/邀請行為。遊戲只能選擇一項服務。
  9. 平台 UI 不會停用已滿的活動 (currentPlayers 等於 maxPlayers)。這主要是為了避免競爭情形，而且 currentPlayers 也是選擇性欄位。如果您想要在已滿的情況下限制可加入性，您需要刪除活動，或在玩家加入時處理已滿的錯誤情況。建議顯示錯誤訊息，因為遊戲本來就必須處理這種情況。
最後修改於 2026年10月8日

相關主題

MPSD 邀請與活動疑難排解指南概念MPA多人遊戲活動 (MPA) 概念XBOX PC 遠端工具常見問題集與疑難排解指南