Skip to main content

XUserGamertagComponent

가져올 게이머태그의 유형(또는 구성 요소)을 지정합니다.

구문

상수

설명

각 게이머태그 구성 요소의 길이 제한 및 버퍼 크기는 다음과 같습니다.
  • 클래식 게이머태그 (XUserGamertagComponent::Classic)
    • 최대 길이는 15자이며, null 종결자가 추가됩니다. 클래식 게이머태그는 항상 15자로 제한되어 있습니다.
    • 최대 버퍼 크기는 null 종결자를 포함하여 16바이트입니다. (15개의 US-ASCII 문자) + (1바이트 null 종결자) = 16바이트.
  • 모던 게이머태그 (XUserGamertagComponent::Modern)
    • 최대 길이는 12자이며, 각 문자당 최대 1개의 발음 구별 기호를 가질 수 있고, null 종결자가 추가됩니다.
    • 사용자가 모던 게이머태그를 설정하지 않은 경우 이는 XUserGamertagComponent::Classic과 동일합니다.
    • 최대 버퍼 크기는 null 종결자를 포함하여 97바이트입니다. (12개의 문자 + 12개의 발음 구별 기호) * (4바이트/문자) + (1바이트 null 종결자) = 97바이트.
  • 접미사 (XUserGamertagComponent::ModernSuffix)
    • 최대 길이는 14자(발음 구별 기호 없음)이며, null 종결자가 추가됩니다.
    • 클래식 게이머태그는 접미사가 없습니다(null 종결자만 있음).
    • 최대 버퍼 크기는 null 종결자를 포함하여 15바이트입니다. (14개의 숫자 ASCII 문자) + (1바이트 null 종결자) = 15바이트.
    • 11자 이하의 모던 게이머태그의 경우, 일반적으로 4자리 접미사가 할당됩니다. 해당 4자리 공간이 가득 차면 문자 수가 증가하며, 고유 모던 게이머태그의 총 길이 제한인 16자에 맞도록 가능한 최대 문자 수까지 증가합니다.
  • 고유 모던 게이머태그 (XUserGamertagComponent::UniqueModern)
    • 모던 게이머태그 + ’#’ + 모던 접미사, 또는 ’#‘과 접미사가 없는 클래식 게이머태그를 포함합니다.
    • 최대 길이는 16자이며, null 종결자가 추가됩니다.
    • 최대 버퍼 크기는 null 종결자를 포함하여 101바이트입니다. (12개의 문자 + 12개의 발음 구별 기호) * (4바이트/문자) + ’#’ (1바이트) + (3개의 숫자 US-ASCII 문자) + null 종결자 (1바이트) = 101바이트.
    • 고유 모던 게이머태그의 16자 제한은 12자의 모던 게이머태그가 3자리 접미사로 제한됨을 의미하며, ’#’ 문자로 인해 총 16개의 렌더링된 문자가 됩니다.
    • 모던 게이머태그의 문자 수가 감소함에 따라 접미사 문자 수는 증가할 수 있지만, 고유 모던 게이머태그의 총 최대 바이트 수는 이를 초과하지 않습니다.

요구 사항

헤더: XUser.h 지원되는 플랫폼: Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

함께 보기

XUser XUserGetGamertag 모던 게이머태그
마지막 수정일 2026년 8월 24일