Skip to main content
以下指南是帮助游戏使用 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 文件中的所有 ID 是否设置正确。 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 设置。 MultiplayerProtocol 设置必须设置为 true，以便 Windows 游戏能够正确集成 XBOX Game Bar UI。有关更多详细信息，请参阅 MicrosoftGame.config 概述。
  8. 验证您没有意外地混用 MPA 和 MPSD 服务调用。 MPSD 和 MPA 服务不能同时使用。这样做会导致意外的活动/加入/邀请行为。游戏必须仅选择一项服务。
  9. 平台 UI 不会禁用已满的活动（currentPlayers 等于 maxPlayers）。这主要是为了避免竞争条件，但 currentPlayers 也是一个可选字段。如果您想在已满情况下限制可加入性，则需要删除活动或处理玩家加入时已满的错误情况。建议使用错误消息，因为无论如何游戏都必须处理此情况。
最后修改于 2026年8月25日

相关主题

MPSD 邀请和活动故障排除指南概念Multiplayer Activity (MPA) 概念多人游戏会话目录 (MPSD) 概念XBOX PC Remote 工具常见问题解答和故障排除指南