Skip to main content

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

认证测试用例

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

所需工具
  • 来自 GDK 的 XblTestAccountGui.exe
准备工作 为以下每个名称创建四个测试账户,并使用 XblTestAccountGui.exe 将每个测试账户的玩家代号更改为以下内容:
  • สฐ众нь컴퓨퓨
  • आथाώঙぁヺ
  • øÜêþЯЂў
  • gttest1
测试步骤
  1. 找到并查看游戏中显示玩家代号的位置。
  2. 检查步骤 1 中确定的所有区域中用户的玩家代号如何显示。
  3. 如果游戏显示用户的图片,请验证是否为每个账户显示了正确的 Microsoft 账户图片或游戏图片。
预期结果 必须正确显示用户的玩家代号。 通过示例
  1. 使用现代玩家代号时,玩家代号正确显示 Unicode 字符(包括自动生成的后缀)。
  2. 使用经典玩家代号时,玩家代号显示正确。
失败示例
  1. 由于 Unicode 字符显示为空白字符,玩家代号根本没有呈现。
  2. 使用经典玩家代号时,玩家代号未正确显示。
最后修改于 2026年8月13日