Déterminer les paramètres régionaux et la langue de la console

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

1. Les langues déclarées dans MicrosoftGame.config.
2. Les langues déclarées dans le fichier de disposition du package.
3. La langue sélectionnée sur l’appareil.

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

​

Exemples

​

1. Les paramètres régionaux de l’utilisateur correspondent à une ressource prise en charge

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

• XPackageGetUserLocale renvoie fr-FR.
• GetUserDefaultLocaleName renvoie fr-FR.

​

2. Paramètres régionaux de l’utilisateur absents du manifeste, mais la même langue existe

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

• XPackageGetUserLocale renvoie en-US (repli au sein de la même langue).
• GetUserDefaultLocaleName renvoie en-GB (toujours la valeur de la console).

​

3. Langue de l’utilisateur totalement absente

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

• XPackageGetUserLocale renvoie en-US (première entrée de Resources).
• GetUserDefaultLocaleName renvoie fr-FR.

​

Résumé

• GetUserDefaultLocaleName : la valeur définie sur la console, sans tenir compte des langues déclarées par le jeu.
• XPackageGetUserLocale : la langue à charger, selon la logique suivante :
  1. Si les paramètres régionaux de l’utilisateur figurent dans MicrosoftGame.config, les renvoyer.
  2. Sinon, rechercher des paramètres régionaux de la même langue dans le manifeste (meilleur repli en fonction des paramètres régionaux de l’utilisateur).
  3. Sinon, renvoyer les premiers paramètres régionaux de Resources.
  4. Si aucune langue n’est répertoriée, renvoyer la langue de la console.

​

Voir aussi

• XPackageGetUserLocale
• Localisation de MicrosoftGame.config

​

Documentation des API associées

• Référence des fonctionnalités XGameRuntime : XGameRuntimeLocale pour les paramètres régionaux actifs
• Référence de l’API XPackage : requêtes de ressources de package tenant compte des paramètres régionaux