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

# XR-047 用户配置文件访问

> XR-047 要求游戏在任何显示名称出现的地方,通过 XGameUiShowPlayerProfileCardAsync 或 ShowProfileCardUIAsync 提供其他用户的 XBOX 玩家卡。

# XR-047:用户配置文件访问 \*

版本 1.2,2025/03/01

游戏必须在枚举用户显示名称的任何地方,为用户提供访问其他 XBOX 网络用户的玩家卡(用户配置文件)的选项。

## 更多信息

一致的玩家卡访问有助于维持一个统一的平台生态系统,并为用户提供访问 XBOX 社交功能和安全选项的可靠方式。此要求适用的示例包括排行榜、会话大厅、比赛后统计以及其他游戏内菜单。

要执行此操作,游戏必须在控制台上使用 `XGameUiShowPlayerProfileCardAsync` API,而在为 Windows 开发时使用 `ShowProfileCardUIAsync` API。有关这些 API 的更多信息,请参阅目标平台的开发文档。

### 例外

此要求不适用于在无法进行界面导航的区域显示名称。示例包括:

* 缺乏任何互动性或用户输入的静态加载屏幕。
* 活动游戏期间的抬头显示。

<Warning>
  此例外不适用于排行榜和菜单,包括在活动游戏期间作为可导航覆盖层出现的排行榜和菜单。

  XR-047 要求不会通过在合理预期具有可导航界面的位置选择性地禁用/不启用导航而被作废。如果在适用范围内的位置中无法进行导航,请提交例外请求。
</Warning>

### 实现指南和最佳实践

如果游戏使用 XBOX 玩家代号以外的显示名称,则 XBOX 用户之间仍需要玩家卡访问。

游戏级别的安全选项(举报、静音等)和社交功能的可用性不会消除 XBOX 用户之间对玩家卡访问的需求。

## 认证测试用例

### 047-01 用户配置文件访问

**测试步骤**

1. 设备 1 和 2:启动游戏。
2. 设备 1 和 2:登录 XBOX 配置文件。
3. 设备 1:设置一个 XBOX 多人游戏会话。
4. 设备 2:查找并加入设备 1 创建的游戏会话。
5. 设备 2 加入游戏会话后,验证以下内容:
   * 从游戏前大厅,通过选择玩家代号或用户名访问另一个 XBOX 用户的玩家卡。
   * 在游戏过程中,尝试通过选择用户的用户名或玩家代号访问另一个 XBOX 用户的玩家卡(根据游戏,这可能可行也可能不可行)。
   * 从游戏后统计屏幕,通过选择用户的用户名或玩家代号访问另一个 XBOX 用户的玩家卡。
   * 从排行榜区域,通过选择用户的用户名或玩家代号访问另一个 XBOX 用户的玩家卡。
   * 查找列出玩家代号的其他任何区域,并尝试通过选择用户的用户名或玩家代号访问另一个 XBOX 用户的玩家卡。

**预期结果**

用户能够查看其他 XBOX 用户的玩家卡信息。

**通过示例**

1. 在显示玩家代号且启用了界面导航的所有位置,用户能够访问另一个 XBOX 用户的玩家卡。
2. 无论是否启用了界面导航,用户都能够在排行榜、会话大厅、游戏后统计以及其他游戏内菜单中访问另一个 XBOX 用户的玩家卡。

**失败示例**

1. 在显示玩家代号且可以进行界面导航的任何位置,用户无法访问另一个 XBOX 用户的玩家卡。
2. 无论是否启用了界面导航,用户都无法在排行榜、会话大厅、游戏后统计以及其他游戏内菜单中访问另一个 XBOX 用户的玩家卡。


## Related topics

- [XBOX 认证概览](/zh-CN/publishing/certification/overview.md)
- [XBOX 要求 (XR) 认证参考](/zh-CN/publishing/certification/xbox-requirements.md)
- [XR-018 用户生成的内容](/zh-CN/publishing/certification/xr/xr-018.md)
- [用户配置文件](/zh-CN/services/xbox-services/fundamentals/identity/user-profile/index.md)
- [PC 和移动认证要求以及最常见的失败](/zh-CN/publishing/certification/pc-certification.md)
