> ## 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.

# Determinación de la configuración regional y el idioma de la consola

> Use GetUserDefaultLocaleName y XPackageGetUserLocale para detectar el idioma de la consola XBOX y cargar los recursos localizados que mejor coincidan en su título de GDK.

Recupere la configuración regional de la sesión con la que se ha iniciado sesión mediante [`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.
```

Normalmente a los juegos no les importa la configuración regional exacta, sino **qué recursos de idioma cargar**. Elija el idioma del paquete del juego que sea "más cercano" al que seleccionó el usuario. Hay tres entradas que importan:

1. Los idiomas declarados en `MicrosoftGame.config`.
2. Los idiomas declarados en el archivo de diseño del paquete.
3. El idioma seleccionado en el dispositivo.

Use [`XPackageGetUserLocale`](/reference/system/xpackage/functions/xpackagegetuserlocale) para obtener siempre el idioma admitido más cercano:

```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);
}
```

## Ejemplos

### 1. La configuración regional del usuario coincide con un recurso admitido

El usuario selecciona **francés / Francia (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` devuelve `fr-FR`.
* `GetUserDefaultLocaleName` devuelve `fr-FR`.

### 2. La configuración regional del usuario no está en el manifiesto, pero existe el mismo idioma

El usuario selecciona **inglés / Reino Unido (en-GB)**. `MicrosoftGame.config`:

```xml theme={null}
<Resources>
    <Resource Language="en-US"/>
    <Resource Language="fr-FR"/>
    <Resource Language="de-DE"/>
</Resources>
```

* `XPackageGetUserLocale` devuelve `en-US` (reserva dentro del mismo idioma).
* `GetUserDefaultLocaleName` devuelve `en-GB` (siempre el valor de la consola).

### 3. El idioma del usuario no está presente en absoluto

La configuración regional del usuario es `fr-FR`. `MicrosoftGame.config`:

```xml theme={null}
<Resources>
    <Resource Language="en-US"/>
    <Resource Language="de-DE"/>
</Resources>
```

* `XPackageGetUserLocale` devuelve `en-US` (primera entrada de `Resources`).
* `GetUserDefaultLocaleName` devuelve `fr-FR`.

## Resumen

* `GetUserDefaultLocaleName`: la configuración establecida en la consola, sin tener en cuenta los idiomas declarados por el juego.
* `XPackageGetUserLocale`: qué idioma cargar, según esta lógica:
  1. Si la configuración regional del usuario está en `MicrosoftGame.config`, la devuelve.
  2. En caso contrario, busca en el manifiesto una configuración regional del mismo idioma (la mejor reserva según la configuración regional del usuario).
  3. En caso contrario, devuelve la primera configuración regional de `Resources`.
  4. Si no hay idiomas enumerados, devuelve el idioma de la consola.

## Consulte también

* [XPackageGetUserLocale](/reference/system/xpackage/functions/xpackagegetuserlocale)
* [Localización de MicrosoftGame.config](/build/core-features/common/game-config/MicrosoftGameConfig-Localization)

## Documentación de API relacionada

* [Referencia de características de XGameRuntime](/reference/system/xgameruntimefeature/xgameruntimefeature_members): `XGameRuntimeLocale` para la configuración regional activa
* [Referencia de la API XPackage](/reference/system/xpackage/xpackage_members): consultas de recursos del paquete que tienen en cuenta la configuración regional


## Related topics

- [Información general sobre localización y globalización](/es/build/game-principles/localization.md)
- [XPackageGetUserLocale](/es/reference/system/xpackage/functions/xpackagegetuserlocale.md)
- [Determinación de la ubicación de la consola](/es/build/game-principles/localization/determining-console-geolocation.md)
- [XBOX Manager: administración de la configuración de la consola](/es/tools/tools-console/xbom/manager-tool-console-settings.md)
- [Administración de la configuración de la consola con XBOX Device Portal](/es/tools/tools-console/wdp/windows-device-portal-on-xbox-settings.md)