Determinación de la configuración regional y el idioma de la consola

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

1. Los idiomas declarados en MicrosoftGame.config.
2. Los idiomas declarados en el archivo de diseño del paquete.
3. El idioma seleccionado en el dispositivo.

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

​

Ejemplos

​

1. La configuración regional del usuario coincide con un recurso admitido

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

• XPackageGetUserLocale devuelve fr-FR.
• GetUserDefaultLocaleName devuelve fr-FR.

​

2. La configuración regional del usuario no está en el manifiesto, pero existe el mismo idioma

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

• XPackageGetUserLocale devuelve en-US (reserva dentro del mismo idioma).
• GetUserDefaultLocaleName devuelve en-GB (siempre el valor de la consola).

​

3. El idioma del usuario no está presente en absoluto

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

• XPackageGetUserLocale devuelve en-US (primera entrada de Resources).
• GetUserDefaultLocaleName devuelve fr-FR.

​

Resumen

• GetUserDefaultLocaleName: la configuración establecida en la consola, sin tener en cuenta los idiomas declarados por el juego.
• XPackageGetUserLocale: qué idioma cargar, según esta lógica:
  1. Si la configuración regional del usuario está en MicrosoftGame.config, la devuelve.
  2. En caso contrario, busca en el manifiesto una configuración regional del mismo idioma (la mejor reserva según la configuración regional del usuario).
  3. En caso contrario, devuelve la primera configuración regional de Resources.
  4. Si no hay idiomas enumerados, devuelve el idioma de la consola.

​

Consulte también

• XPackageGetUserLocale
• Localización de MicrosoftGame.config

​

Documentación de API relacionada

• Referencia de características de XGameRuntime: XGameRuntimeLocale para la configuración regional activa
• Referencia de la API XPackage: consultas de recursos del paquete que tienen en cuenta la configuración regional