Determinação da localidade e do idioma do console

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

1. Idiomas declarados no MicrosoftGame.config.
2. Idiomas declarados no arquivo de layout do pacote.
3. Idioma selecionado no dispositivo.

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

​

Exemplos

​

1. A localidade do usuário corresponde a um recurso compatível

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

• XPackageGetUserLocale retorna fr-FR.
• GetUserDefaultLocaleName retorna fr-FR.

​

2. A localidade do usuário não está no manifesto, mas o mesmo idioma existe

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

• XPackageGetUserLocale retorna en-US (fallback dentro do mesmo idioma).
• GetUserDefaultLocaleName retorna en-GB (sempre o valor do console).

​

3. O idioma do usuário não está presente

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

• XPackageGetUserLocale retorna en-US (primeira entrada em Resources).
• GetUserDefaultLocaleName retorna fr-FR.

​

Resumo

• GetUserDefaultLocaleName — o que está definido no console, ignorando os idiomas declarados pelo jogo.
• XPackageGetUserLocale — qual idioma carregar, usando esta lógica:
  1. Se a localidade do usuário estiver no MicrosoftGame.config, retorna essa localidade.
  2. Caso contrário, encontra uma localidade do mesmo idioma no manifesto (o melhor fallback com base na localidade do usuário).
  3. Caso contrário, retorna a primeira localidade em Resources.
  4. Se nenhum idioma estiver listado, retorna o idioma do console.

​

Veja também

• XPackageGetUserLocale
• Localização do MicrosoftGame.config

​

Documentação de API relacionada

• Referência de recursos do XGameRuntime — XGameRuntimeLocale para a localidade ativa
• Referência da API XPackage — consultas de recursos do pacote com reconhecimento de localidade