> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Utilisez GetUserDefaultLocaleName et XPackageGetUserLocale pour détecter la langue de la console XBOX et charger les ressources localisées les plus proches dans votre titre GDK.

Récupérez les paramètres régionaux de la session connectée avec [`GetUserDefaultLocaleName`](https://learn.microsoft.com/windows/win32/api/winnls/nf-winnls-getuserdefaultlocalename) :

```cpp theme={null}
wchar_t localeName[LOCALE_NAME_MAX_LENGTH];
int retVal = GetUserDefaultLocaleName(localeName, ARRAYSIZE(localeName));
// The value is returned in localeName.
```

En général, les jeux ne se soucient pas des paramètres régionaux exacts : ce qui compte, c'est **quelles ressources linguistiques charger**. Choisissez la langue du package du jeu la « plus proche » de celle sélectionnée par l'utilisateur. Trois éléments entrent en jeu :

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.

Utilisez [`XPackageGetUserLocale`](/fr/reference/system/xpackage/functions/xpackagegetuserlocale) pour toujours obtenir la langue prise en charge la plus proche :

```cpp theme={null}
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

L'utilisateur sélectionne **Français / France (fr-FR)**. `MicrosoftGame.config` :

```xml theme={null}
<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

L'utilisateur sélectionne **Anglais / Royaume-Uni (en-GB)**. `MicrosoftGame.config` :

```xml theme={null}
<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

Les paramètres régionaux de l'utilisateur sont `fr-FR`. `MicrosoftGame.config` :

```xml theme={null}
<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](/fr/reference/system/xpackage/functions/xpackagegetuserlocale)
* [Localisation de MicrosoftGame.config](/fr/build/core-features/common/game-config/MicrosoftGameConfig-Localization)

## Documentation des API associées

* [Référence des fonctionnalités XGameRuntime](/fr/reference/system/xgameruntimefeature/xgameruntimefeature_members) : `XGameRuntimeLocale` pour les paramètres régionaux actifs
* [Référence de l'API XPackage](/fr/reference/system/xpackage/xpackage_members) : requêtes de ressources de package tenant compte des paramètres régionaux


## Related topics

- [Exigences XBOX testées lors de la certification pour les jeux sur console XBOX](/fr-CA/publishing/certification/console-cert-tested-requirements.md)
- [XR-003 Qualité du titre pour la soumission](/fr-CA/publishing/certification/xr/xr-003.md)
- [Guide BVT de certification pour console](/fr/publishing/game-publishing/concepts/certification/certification-console-bvt-guide.md)
- [Guide des BVT de certification pour console](/fr-CA/publishing/game-publishing/concepts/certification/certification-console-bvt-guide.md)
- [Étapes de test de validation des supports](/fr-CA/publishing/game-publishing/concepts/certification/certification-media-validation-test-steps.md)