> ## 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étermination des paramètres régionaux et de 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.
```

Les jeux ne se soucient généralement pas des paramètres régionaux exacts : ce qui compte, c'est **quelles ressources linguistiques charger**. Choisissez la langue du package du jeu qui est la « plus proche » de celle que l'utilisateur a sélectionnée. 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-CA/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` 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

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` 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

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

## Documentation des API connexes

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


## Related topics

- [Étapes de test de validation des supports](/fr-CA/publishing/game-publishing/concepts/certification/certification-media-validation-test-steps.md)
- [Étapes du test de validation des supports](/fr/publishing/game-publishing/concepts/certification/certification-media-validation-test-steps.md)
- [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 de certification étape par étape](/fr-CA/publishing/game-publishing/concepts/certification/certification-guide.md)