跳转到主要内容
版本 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 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. 使用经典玩家代号时,玩家代号未正确显示。
最后修改于 2026年10月20日