通过

MPA 邀请和活动故障排除指南

以下指南是帮助游戏使用 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 和 Identity 信息。

  5. 在合作伙伴中心中验证游戏的设备可用性。
    合作伙伴中心的“游戏设置”/“设备系列可用性”设置可以限制游戏的功能和可用性。 确保已启用所有相关平台。 默认情况下，如果未设置 Xbox Series X|S 设备系列，Xbox One 设备将支持跨平台游戏。

  6. 验证游戏是否未限制为“特定受众”组。
    将游戏可见性限制为“特定受众”(在合作伙伴中心中为“定价和可用性”/“可见性”)可能会限制游戏访问和服务功能。 例如，如果已登录用户不属于“特定受众”，则返回的“最近的玩家”信息将不包括正确的游戏名称。 如果启用此功能，请确保主机/用户都属于“特定受众”组。

  7. 验证电脑游戏的 MicrosoftGame.config 文件中是否存在 MultiplayerProtocol 设置。
    Windows 游戏的 MultiplayerProtocol 设置必须设为 true，才能正确集成 Xbox Game Bar UI。 有关更多详细信息，请参阅 MicrosoftGame.config 概述。

  8. 验证你是否未意外混合 MPA 和 MPSD 服务调用。
    不能同时使用 MPSD 和 MPA 服务。 这样做将导致意外的“活动/加入/邀请”行为。 游戏必须仅选择一项服务。

  9. 平台 UI 不会禁用完全 (currentPlayers 等于 maxPlayers) 的活动。 这主要是为了避免争用条件，也是 currentPlayers 一个可选字段。 如果要在完整情况下限制可加入性，则需要删除活动或处理玩家加入且已满时的错误情况。 建议使用错误消息，因为需要通过游戏进行处理。