​

XUserGamertagComponent

​

Syntax

enum class XUserGamertagComponent  : uint32_t  
{  
    Classic = 0,  
    Modern = 1,  
    ModernSuffix = 2,  
    UniqueModern = 3,  
}  

​

Constants

​

Remarks

• 经典玩家代号 (XUserGamertagComponent::Classic)
  • 最大长度为 15 个字符，外加一个 null 终止符。经典玩家代号一直被限制为 15 个字符。
  • 缓冲区最大大小为 16 字节，包括 null 终止符的空间；(15 个 US-ASCII 字符) + (1 字节 null 终止符) = 16 字节。
• 新式玩家代号 (XUserGamertagComponent::Modern)
  • 最大长度为 12 个字符，每个字符最多带有 1 个变音符号，外加一个 null 终止符。
  • 如果用户未设置新式玩家代号，则此项与 XUserGamertagComponent::Classic 相同。
  • 缓冲区最大大小为 97 字节，包括 null 终止符的空间；(12 个字符 + 12 个变音符号) * (4 字节/字符) + (1 字节 null 终止符) = 97 字节。
• 后缀 (XUserGamertagComponent::ModernSuffix)
  • 最大长度为 14 个字符（无变音符号），外加一个 null 终止符。
  • 经典玩家代号没有后缀（只有 null 终止符）。
  • 缓冲区最大大小为 15 字节，包括 null 终止符的空间；(14 个数字 ASCII 字符) + (1 字节 null 终止符) = 15 字节。
  • 对于 11 个字符或以下的新式玩家代号，通常分配 4 位数字后缀。 如果 4 位数字空间已用完，字符数将增加，最多可达到唯一新式玩家代号 16 个字符总长度限制内允许的最大字符数。
• 唯一新式玩家代号 (XUserGamertagComponent::UniqueModern)
  • 包含新式玩家代号 + ’#’ + 新式后缀，或者经典玩家代号不带 ’#’ 也没有后缀。
  • 最大长度为 16 个字符，外加一个 null 终止符。
  • 缓冲区最大大小为 101 字节，包括 null 终止符的空间；(12 个字符 + 12 个变音符号) * (4 字节/字符) + ’#’ (1 字节) + (3 个数字 US-ASCII 字符) + null 终止符 (1 字节) = 101 字节。
  • 唯一新式玩家代号的 16 个字符限制意味着，具有 12 个字符的新式玩家代号仅限于 3 位数字后缀，因为有 ’#’ 字符，所以总计呈现 16 个字符。
  • 随着新式玩家代号中字符数的减少，后缀字符数可以增加，但唯一新式玩家代号的总最大字节数永远不会超过此值。

​

Requirements

​

See also