> ## 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.

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

> 通过检查加入限制、跨平台游玩标志、沙盒、游戏 ID 和 Partner Center 设置来排查 XBOX Multiplayer Activity 邀请和活动问题。

以下指南是帮助游戏使用 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 概述](/build/core-features/common/game-config/MicrosoftGameConfig-Overview)。

8. 验证您没有意外地混用 MPA 和 MPSD 服务调用。
   MPSD 和 MPA 服务不能同时使用。这样做会导致意外的活动/加入/邀请行为。游戏必须仅选择一项服务。

9. 平台 UI 不会禁用已满的活动（`currentPlayers` 等于 `maxPlayers`）。这主要是为了避免竞争条件，但 `currentPlayers` 也是一个可选字段。如果您想在已满情况下限制可加入性，则需要删除活动或处理玩家加入时已满的错误情况。建议使用错误消息，因为无论如何游戏都必须处理此情况。