XUserGamertagComponent
Spécifie le type (ou composant) de gamertag à récupérer.Syntaxe
Constantes
Remarques
La limite de longueur et la taille de la mémoire tampon de chaque composant de gamertag sont les suivantes.-
Gamertag classique (
XUserGamertagComponent::Classic)- Longueur maximale de 15 caractères, plus un terminateur null. Les gamertags classiques ont toujours été limités à 15 caractères.
- La taille maximale de la mémoire tampon est de 16 octets, espace du terminateur null compris ; (15 caractères US-ASCII) + (terminateur null de 1 octet) = 16 octets.
-
Gamertag moderne (
XUserGamertagComponent::Modern)- Longueur maximale de 12 caractères, chaque caractère étant limité à un signe diacritique au maximum, plus un terminateur null.
-
Si l’utilisateur n’a défini aucun gamertag moderne, il est identique à
XUserGamertagComponent::Classic. - La taille maximale de la mémoire tampon est de 97 octets, espace du terminateur null compris ; (12 caractères + 12 signes diacritiques) * (4 octets/caractère) + (terminateur null de 1 octet) = 97 octets.
-
Suffixe (
XUserGamertagComponent::ModernSuffix)- Longueur maximale de 14 caractères (sans signes diacritiques), plus un terminateur null.
- Les gamertags classiques n’ont pas de suffixe (uniquement le terminateur null).
- La taille maximale de la mémoire tampon est de 15 octets, espace du terminateur null compris ; (14 caractères ASCII numériques) + (terminateur null de 1 octet) = 15 octets.
- Pour les gamertags modernes de 11 caractères ou moins, des suffixes à 4 chiffres sont normalement attribués. Si cet espace à 4 chiffres est saturé, le nombre de caractères augmente, jusqu’au nombre maximal de caractères permettant de respecter la limite de longueur totale de 16 caractères du gamertag moderne unique.
-
Gamertag moderne unique (
XUserGamertagComponent::UniqueModern)- Contient soit le gamertag moderne + ’#’ + le suffixe moderne, soit le gamertag classique sans ’#’ ni suffixe.
- Longueur maximale de 16 caractères, plus un terminateur null.
- La taille maximale de la mémoire tampon est de 101 octets, espace du terminateur null compris ; (12 caractères + 12 signes diacritiques) * (4 octets/caractère) + ’#’ (1 octet) + (3 caractères US-ASCII numériques) + terminateur null (1 octet) = 101 octets.
- La limite de 16 caractères d’un gamertag moderne unique signifie qu’un gamertag moderne de 12 caractères est limité à un suffixe à 3 chiffres, ce qui donne un total de 16 caractères affichés en raison du caractère ’#’.
- À mesure que le nombre de caractères du gamertag moderne diminue, le nombre de caractères du suffixe peut augmenter, mais le nombre total maximal d’octets du gamertag moderne unique ne dépassera jamais cette valeur.
