Détermination des paramètres régionaux et de 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 retourne fr-FR.
• GetUserDefaultLocaleName retourne fr-FR.

​

2. Les paramètres régionaux de l’utilisateur ne figurent pas dans le manifeste, mais la même langue existe

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

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

​

3. La langue de l’utilisateur est totalement absente

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

• XPackageGetUserLocale retourne en-US (première entrée de Resources).
• GetUserDefaultLocaleName retourne 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, ils sont retournés.
  2. Sinon, recherche de paramètres régionaux de la même langue dans le manifeste (meilleur repli selon les paramètres régionaux de l’utilisateur).
  3. Sinon, retour des premiers paramètres régionaux de Resources.
  4. Si aucune langue n’est indiquée, retour de la langue de la console.

​

Voir aussi

• XPackageGetUserLocale
• Localisation de MicrosoftGame.config

​

Documentation des API connexes

• 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