​

XUserGamertagComponent

​

語法

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

​

常數

​

備註

• 傳統玩家代號 (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 個字元。
  • 隨著新式玩家代號的字元數減少，尾碼字元數可以增加，但唯一新式玩家代號的總位元組數上限永遠不會超過此值。

​

需求

​

另請參閱