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

以下指南是一个起点,可协助标题使用 MPSD 对邀请和活动功能进行故障排除。使用此 MPSD 功能并遇到问题的标题开发者,首先应确保所使用的 MPSD 会话有效,并且 MPSD 调用上没有其他 API 错误或 HTTP 错误。在没有错误的情况下,禁用邀请/活动加入 UI 最常见的原因是标题或服务配置不正确。最佳的故障排除方法是按照以下步骤操作:

验证 MPSD 会话未关闭、未锁定或未满。对于已关闭 ("closed": true) 或已满的会话,邀请和加入会被禁用。锁定的 MPSD 会话 ("locked": true) 仅允许先前的会话成员重新加入。
验证测试中所有标题实例的沙盒和 titleID。所有标题实例都需要位于相同的沙盒中,使用相同的 titleID(和 SCID),并且必须在此沙盒中配置 MPSD 会话模板。
验证 MicrosoftGame.config 文件中的所有 ID 是否设置正确。 MicrosoftGame.config 必须包含正确的 titleID、SCID,并且 Identity 信息与合作伙伴中心配置(在“游戏设置”中可见)匹配。
验证您的场景是否具有正确的 MPSD 会话配置。
- inviteProtocol 常量在 MPSD 会话中定义。为了实现正确的邀请行为,标题必须设置 "inviteProtocol": "game" 常量。
- MPSD 会话不包含任何加入限制。验证 joinRestriction 属性未设置为 followed/local,以防止非关注者加入或完全限制加入。
- 正确设置 MPSD 会话的 userAuthorizationStyle 属性。对于非主机设备的 MPSD 会话,必须启用 userAuthorizationStyle 属性,并且还需要 joinRestriction(“local”或“followed”)。这是一项系统限制,用于防止任意玩家加入,无法移除。
推荐的 MPSD 模板配置为:

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

验证邀请/加入问题是否不仅限于跨设备场景。如果邀请/加入问题仅发生在不同主机类型之间(XBOX Series X|S、XBOX One)或主机与 PC 之间,则标题或 MPSD 会话的 crossPlay 配置可能不正确。默认情况下,如果未设置 XBOX Series X|S 设备系列,XBOX One 设备将支持跨平台游玩。
- 一旦您的标题在 XBOX One 以外的其他平台上发布,请验证在合作伙伴中心“XBOX 设置”/“设备系列”列表中启用了所有相关平台。
- 验证已启用跨平台游玩 MPSD 会话功能 ("crossPlay": true)。
推荐的 MPSD 模板配置为:

     /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)

验证会话的所有权行为是否未导致邀请限制。设置了 hasOwners 和会话所有者的会话,还需要将 allowNonOwnerInviteHandles 设置为 true,以便非所有者发送邀请。请根据所需行为相应地设置此常量。
验证您的标题在合作伙伴中心中的设备可用性。合作伙伴中心中的“游戏设置”/“设备系列可用性”设置可限制您的标题的功能和可用性。确保启用了所有相关平台。默认情况下,如果未设置 XBOX Series X|S 设备系列,XBOX One 设备将支持跨平台游玩。
验证您的标题未仅限于私人受众组。将标题可见性限制为私人受众(合作伙伴中心中的“定价和可用性”/“可见性”)可能会限制标题访问和服务功能。如果启用此项,请确保两个主机/用户都是私人受众组的一部分。
验证 PC 标题的 MicrosoftGame.config 文件中存在 MultiplayerProtocol 设置。对于 Windows 标题,必须将 MultiplayerProtocol 设置为 true,以启用与 XBOX Game Bar UI 的正确集成。有关详细信息,请参阅 MicrosoftGame.config 概述。
验证您没有意外混用 MPA 和 MPSD 服务调用。 MPSD 和 MPA 服务不能同时使用。这样做将导致意外的活动/加入/邀请行为。标题必须仅选择一种服务。

XBOX Services

PlayFab