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

> 在 XBOX 控制台上,游戏必须使用玩家代号作为其主要显示名称,并正确呈现现代或经典玩家代号的所有字符。

# XR-046:显示名称和游戏图片 \*

版本 2.0,2024/10/01

在 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` API 返回。在 ERA 中,玩家代号是通过 `GetUserProfileAsync` API 获取的。

<Note>
  现代玩家代号支持的泰语和天城文所需的 Unicode 变音符号支持经常导致问题,而这些问题往往要到测试的后期阶段才能被发现。如果尝试在游戏中支持现代玩家代号,请及早规划和测试这些语言的字符。
</Note>

## 认证测试用例

### 046-01 显示名称和游戏图片

**所需工具**

* 来自 GDK 的 `XblTestAccountGui.exe`

**准备工作**

为以下每个名称创建四个测试账户,并使用 `XblTestAccountGui.exe` 将每个测试账户的玩家代号更改为以下内容:

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

**测试步骤**

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

**预期结果**

必须正确显示用户的玩家代号。

**通过示例**

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

**失败示例**

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