> ## 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": true`) 或已满的会话,邀请和加入会被禁用。锁定的 MPSD 会话 (`"locked": true`) 仅允许先前的会话成员重新加入。

2. 验证测试中所有标题实例的沙盒和 titleID。
   所有标题实例都需要位于相同的沙盒中,使用相同的 titleID(和 SCID),并且必须在此沙盒中配置 MPSD 会话模板。

3. 验证 MicrosoftGame.config 文件中的所有 ID 是否设置正确。
   MicrosoftGame.config 必须包含正确的 titleID、SCID,并且 Identity 信息与合作伙伴中心配置(在“游戏设置”中可见)匹配。

4. 验证您的场景是否具有正确的 MPSD 会话配置。

   * inviteProtocol 常量在 MPSD 会话中定义。为了实现正确的邀请行为,标题必须设置 `"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 以外的其他平台上发布,请验证在合作伙伴中心“XBOX 设置”/“设备系列”列表中启用了所有相关平台。

   * 验证已启用跨平台游玩 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. 验证您的标题在合作伙伴中心中的设备可用性。
   合作伙伴中心中的“游戏设置”/“设备系列可用性”设置可限制您的标题的功能和可用性。确保启用了所有相关平台。默认情况下,如果未设置 XBOX Series X|S 设备系列,XBOX One 设备将支持跨平台游玩。

8. 验证您的标题未仅限于私人受众组。
   将标题可见性限制为私人受众(合作伙伴中心中的“定价和可用性”/“可见性”)可能会限制标题访问和服务功能。如果启用此项,请确保两个主机/用户都是私人受众组的一部分。

9. 验证 PC 标题的 MicrosoftGame.config 文件中存在 MultiplayerProtocol 设置。
   对于 Windows 标题,必须将 MultiplayerProtocol 设置为 true,以启用与 XBOX Game Bar UI 的正确集成。有关详细信息,请参阅 [MicrosoftGame.config 概述](/build/core-features/common/game-config/MicrosoftGameConfig-Overview)。

10. 验证您没有意外混用 MPA 和 MPSD 服务调用。
    MPSD 和 MPA 服务不能同时使用。这样做将导致意外的活动/加入/邀请行为。标题必须仅选择一种服务。


## Related topics

- [MPA 邀请和活动故障排除指南](/zh-CN/services/xbox-services/multiplayer/mpa/concepts/live-mpa-troubleshooting.md)
- [多人游戏会话目录 (MPSD) 概念](/zh-CN/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-concepts-nav.md)
- [概念](/zh-CN/services/xbox-services/multiplayer/mpsd/concepts/index.md)
- [Multiplayer Activity (MPA) 概念](/zh-CN/services/xbox-services/multiplayer/mpa/concepts/live-mpa-concepts-nav.md)
- [XBOX PC Remote 工具常见问题解答和故障排除指南](/zh-CN/tools/tools-pc/xbox-pc-remote-tools/faq.md)