콘솔 로케일 및 언어 확인

wchar_t localeName[LOCALE_NAME_MAX_LENGTH];
int retVal = GetUserDefaultLocaleName(localeName, ARRAYSIZE(localeName));
// The value is returned in localeName.

1. MicrosoftGame.config에 선언된 언어.
2. 패키지 레이아웃 파일에 선언된 언어.
3. 디바이스에서 선택된 언어.

char gameLocale[LOCALE_NAME_MAX_LENGTH];
HRESULT hr = XPackageGetUserLocale(_countof(gameLocale), gameLocale);
if (SUCCEEDED(hr))
{
    printf("Game using locale: %s\n", gameLocale);
}

​

예제

​

1. 사용자 로케일이 지원되는 리소스와 일치

<Resources>
    <Resource Language="en-US"/>
    <Resource Language="fr-FR"/>
    <Resource Language="de-DE"/>
    <Resource Language="en-GB"/>
</Resources>

• XPackageGetUserLocale은 fr-FR을 반환합니다.
• GetUserDefaultLocaleName은 fr-FR을 반환합니다.

​

2. 사용자 로케일은 매니페스트에 없지만 동일 언어가 존재

<Resources>
    <Resource Language="en-US"/>
    <Resource Language="fr-FR"/>
    <Resource Language="de-DE"/>
</Resources>

• XPackageGetUserLocale은 en-US를 반환합니다(동일 언어 내에서의 폴백).
• GetUserDefaultLocaleName은 en-GB를 반환합니다(항상 콘솔 값).

​

3. 사용자 언어가 전혀 존재하지 않음

<Resources>
    <Resource Language="en-US"/>
    <Resource Language="de-DE"/>
</Resources>

• XPackageGetUserLocale은 en-US를 반환합니다(Resources의 첫 번째 항목).
• GetUserDefaultLocaleName은 fr-FR을 반환합니다.

​

요약

• GetUserDefaultLocaleName — 게임에 선언된 언어와 무관하게, 콘솔이 설정된 값입니다.
• XPackageGetUserLocale — 로드할 언어를 다음 로직으로 결정합니다:
  1. 사용자 로케일이 MicrosoftGame.config에 있으면 그것을 반환합니다.
  2. 그렇지 않으면 매니페스트에서 동일 언어의 로케일을 찾습니다(사용자 로케일 기준의 최적 폴백).
  3. 그렇지 않으면 Resources의 첫 번째 로케일을 반환합니다.
  4. 언어가 하나도 나열되어 있지 않으면 콘솔 언어를 반환합니다.

​

참고

• XPackageGetUserLocale
• MicrosoftGame.config 현지화

​

관련 API 문서

• XGameRuntime 기능 레퍼런스 — 활성 로케일을 위한 XGameRuntimeLocale
• XPackage API 레퍼런스 — 로케일 인식 패키지 리소스 쿼리