> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XR-047 用户个人资料访问

> 游戏必须为用户提供访问在游戏中遇到的任何其他 XBOX 用户的玩家卡的选项。

版本 1.3,07/21/2026

游戏必须为用户提供访问在游戏中遇到的任何其他 XBOX 用户的玩家卡(用户个人资料)的选项。

## 详细信息

一致的玩家卡访问有助于维护统一的平台生态系统,并为用户提供访问 XBOX 社交功能和安全选项的可靠方式。

要执行此操作,游戏可以使用 `XGameUiShowPlayerProfileCardAsync` API。如果无法调用此 API,游戏可以使用其他 API(例如 XSAPI)创建在各个 XBOX 终结点之间保持一致的定制自定义玩家卡。自定义玩家卡至少必须包含以下 XBOX 平台元素和选项:

* 玩家代号
* 阻止玩家
* 将玩家静音
* 添加/删除好友
* 转到完整个人资料

### 实现指南和最佳做法

在具有可导航 UI 的区域(例如大厅和大多数游戏内菜单)中显示的用户名应允许选择该用户名,并提供直接打开该玩家玩家卡的提示。

如果用户名显示在无法直接导航或选择的区域(例如正在进行的游戏、平视显示器、静态加载屏幕等),则游戏必须通过相邻的菜单或体验(例如赛后大厅、游戏内玩家列表或其他游戏内位置)提供就近的玩家卡访问。

如果游戏维护了一个可访问的集中位置(例如“社交”选项卡),允许持续访问玩家的玩家卡,则可以使用该位置,而无需在显示这些用户的每个单独 UI 位置中提供玩家卡访问。但是,如果某些 UI 区域显示的用户名未在该集中位置中列出,则这些区域必须提供玩家卡访问。

如果 XBOX 用户的用户名仅显示在不可导航的区域中,并且游戏的其他位置未提供玩家卡访问,则需要申请例外,并根据感知到的风险进行审批。

如果游戏使用 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 用户的玩家卡信息。如果该区域不可导航,或未直接提供玩家卡访问,则用户必须能够从游戏中的就近位置或集中位置调用其他 XBOX 用户的玩家卡。

**通过示例**

1. 用户能够在显示玩家代号且启用了 UI 导航的所有位置访问另一个 XBOX 用户的玩家卡。
2. 用户能够通过游戏中持续可用的集中位置访问另一个 XBOX 用户的玩家卡。
3. 用户能够使用相邻的游戏内体验或游戏中持续可用的集中位置,访问在不可导航的 UI 位置中列出的 XBOX 用户的玩家卡。

**失败示例**

1. 由于 UI 位置、就近的游戏内体验或游戏中持续可用的集中位置均未提供访问,用户无法访问另一个 XBOX 用户的玩家卡。
2. 由于另一个 XBOX 用户的用户名在游戏中的任何位置都不可导航,用户无法访问其玩家卡。


## Related topics

- [经测试的 XBOX 要求](https://docs.xbox.com/zh-CN/publishing/certification/console-cert-tested-requirements.md)
- [XR-018：用户生成内容](https://docs.xbox.com/zh-CN/publishing/certification/xr/xr-018.md)
- [XR047 用户个人资料访问](https://docs.xbox.com/zh-CN/publishing/certification/fma/xr-047.md)
- [XR-048 个人资料设置使用](https://docs.xbox.com/zh-CN/publishing/certification/xr/xr-048.md)
- [XR-052 用户状态、游戏存档位置、漫游和依赖项](https://docs.xbox.com/zh-CN/publishing/certification/xr/xr-052.md)