通过

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 获取玩家代号。

注意

现代玩家代号支持的泰文和 Devanagari 这两种语言所需的 Unicode 音调符号支持经常会导致在测试的后期阶段之前未捕获的问题。 如果尝试在游戏中支持现代玩家代号，请尽早规划和测试这些语言中的字符。

认证测试用例

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

所需工具

  • GDK 中的 XblTestAccountGui.exe

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

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

测试步骤

  1. 找到并查看游戏中显示玩家代号的区域。
  2. 查看用户玩家代号在步骤 [1] 中标识的所有区域中的显示方式。
  3. 如果游戏显示用户的图片，请确认 Microsoft 帐户图片或每个帐户的玩家图片均显示正确。

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

通过示例

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

失败示例

  1. 玩家代号根本不会呈现，因为 Unicode 字符显示为空白字符。
  2. 使用经典玩家代号时，无法正确显示玩家代号。