> ## 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-046 显示名称和玩家图片

> 游戏如何在 XBOX 主机上将新式或经典玩家代号显示为主要显示名称，以及针对玩家代号和玩家图片的 046-01 测试用例。

版本 2.0,10/01/2024

在 XBOX 主机上,游戏必须使用玩家代号作为其主要显示名称。

游戏可以根据设计选择使用玩家的新式玩家代号或经典玩家代号。新式玩家代号在 GDK 中可用,经典玩家代号在 ERA 和 GDK 中均可用。

在非主机平台上,虽然不是必需的,但我们建议在游戏体验中的适当位置使用 XBOX 网络玩家的玩家代号。

必须根据所使用的玩家代号类型在游戏中正确显示玩家代号:

**新式玩家代号**\
显示唯一新式玩家代号的全部 16 个字符,其中包括最多 12 个字符的新式玩家代号,后跟 # 和后缀数字(如果存在)。例如:Major Nelson(不存在后缀)或 Major Nelson#881。如果使用新式玩家代号,则必须支持新式玩家代号可用的所有 Unicode 字符范围。有关新式玩家代号的更多信息和最佳做法,请访问 GDK 开发文档文章“新式玩家代号概述”。

**经典玩家代号**\
正确显示经典玩家代号的全部 15 个字符。经典玩家代号仅包含 ASCII 字符 a-z、A-Z、0-9、逗号 (,) 和空格(ASCII 字符 0x20)。例如:Major Nelson

在 GDK 中,这些项是使用 [XUserGetGamertag](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xusergetgamertag.md) API 返回的。在 ERA 中,使用 `GetUserProfileAsync` API 获取玩家代号。

> \[!Note]
> 新式玩家代号支持的泰语和天城文这两种语言都需要 Unicode 变音符号支持,这经常会导致直到测试后期才被发现的问题。如果尝试在游戏中支持新式玩家代号,请尽早针对这些语言中的字符进行规划和测试。

## 认证测试用例

### 046-01 显示名称和玩家图片

**所需工具**

* GDK 中的 *XblTestAccountGui.exe*

**准备工作**\
为以下每个名称创建四个测试帐户,并使用 *XblTestAccountGui.exe* 将每个测试帐户的玩家代号更改为以下内容:

* **สฐ众нь컴퓨퓨**
* **आथाώঙぁヺ**
* **øÜêþЯЂў**
* **gttest1**

**测试步骤**

1. 找到并查看游戏中显示玩家代号的位置。
2. 检查在步骤 \[1] 中找到的所有区域中用户玩家代号的显示方式。
3. 如果游戏显示用户图片,请验证每个帐户是否显示了正确的 Microsoft 帐户图片或玩家图片。

**预期结果**\
必须正确显示用户的玩家代号。

**通过示例**

1. 使用新式玩家代号时,玩家代号正确显示 Unicode 字符(包括自动生成的后缀)。
2. 使用经典玩家代号时,玩家代号正确显示。

**失败示例**

1. 由于 Unicode 字符显示为空白字符,玩家代号完全未呈现。
2. 使用经典玩家代号时,玩家代号未正确显示。


## Related topics

- [XBOX 游戏的 XBOX 要求](https://docs.xbox.com/zh-CN/publishing/certification/xbox-requirements.md)
- [经测试的 XBOX 要求](https://docs.xbox.com/zh-CN/publishing/certification/console-cert-tested-requirements.md)
- [XBOX 要求和政策支持内容](https://docs.xbox.com/zh-CN/publishing/certification/xr/overview.md)
- [Beta 版和 XBOX 游戏预览版游戏的要求](https://docs.xbox.com/zh-CN/publishing/certification/cert-beta-game-preview.md)
- [XR046 显示名与玩家图片](https://docs.xbox.com/zh-CN/publishing/certification/fma/xr-046.md)