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

# Integración del GDK con un proyecto de Unreal Engine anterior a la versión 4.26

> Conecte el GDK de XBOX a compilaciones de Unreal Engine anteriores a la versión 4.26 editando Build.cs, agregando manualmente las rutas de inclusión y de bibliotecas, e iniciando con wdapp.

Use este tema si está preparando su juego para publicarlo en Microsoft Store para PC y su juego usa una versión de Unreal Engine anterior a la 4.26.

## Uso de una versión anterior de Unreal Engine (anterior a la versión 4.26)

Si usa Unreal Engine versión 4.26 o posterior, consulte [Introducción a Unreal en PC](/build/gdk-and-engines/unreal/unreal).

Si usa Unreal Engine versión 4.25 o anterior, y no puede actualizar a la versión 4.26 o posterior, aún puede integrarse con las experiencias clave del ecosistema de XBOX mediante las bibliotecas de importación de Gaming Runtime y de la XBOX Services API (XSAPI).

Estas bibliotecas de importación permiten que los juegos llamen directamente a las API de Gaming Runtime y a XSAPI, sin tener que agregar un destino de plataforma del GDK al proyecto del juego.

### Adición de encabezados y bibliotecas de importación para Gaming Runtime y XSAPI

1. Busque el archivo de compilación de su proyecto de Unreal: /Source/(ProjectName)/(ProjectName).Build.cs
2. Agregue la línea siguiente para definir la macro **\_GAMING\_DESKTOP**
   ```csharp theme={null}
       PublicDefinitions.Add("_GAMING_DESKTOP");  // For Unreal 4.12 or earlier, use "Definitions.Add()" instead
   ```
3. Agregue las siguientes rutas de inclusión
   ```csharp theme={null}
       // Add the include path for Gaming Runtime
       PublicIncludePaths.Add(@"C:\Program Files (x86)\Microsoft GDK\241000\GRDK\GameKit\Include");
       // Add the include path for XSAPI
       PublicIncludePaths.Add(@"C:\Program Files (x86)\Microsoft GDK\241000\GRDK\ExtensionLibraries\Xbox.Services.API.C\Include");
   ```

> Para Microsoft GDK (junio de 2024) o versiones anteriores, use: *C:\Program Files (x86)\Microsoft GDK\230300\GRDK\ExtensionLibraries\Xbox.Services.API.C\DesignTime\CommonConfiguration\Neutral\Include*

1. Agregue las siguientes rutas de bibliotecas para las bibliotecas de importación
   ```csharp theme={null}
       // Add the import library for Gaming Runtime
       PublicAdditionalLibraries.Add(@"C:\Program Files (x86)\Microsoft GDK\241000\GRDK\GameKit\Lib\amd64\xgameruntime.lib");
       // Add the import library for XSAPI
       PublicAdditionalLibraries.Add(@"C:\Program Files (x86)\Microsoft GDK\241000\GRDK\ExtensionLibraries\Xbox.Services.API.C\Lib\Release\Microsoft.Xbox.Services.142.GDK.C.Thunks.lib");
   ```

> Para Microsoft GDK (junio de 2024) o versiones anteriores, use: *C:\Program Files (x86)\Microsoft GDK\230300\GRDK\ExtensionLibraries\Xbox.Services.API.C\DesignTime\CommonConfiguration\Neutral\Lib\Release\Microsoft.Xbox.Services.141.GDK.C.Thunks.lib*

<Note>
  Las rutas de inclusión y de bibliotecas pueden ser diferentes en su máquina según la versión del GDK y la ubicación de instalación.
</Note>

### Acceso a Gaming Runtime y XSAPI desde archivos de código de C++

1. Determine dónde quiere agregar la integración para cosas como el inicio de sesión y el desbloqueo de logros
2. Agregue los encabezados para Gaming Runtime y XSAPI
   ```cpp theme={null}
       // When using Unreal Engine 4.15 or later
       THIRD_PARTY_INCLUDES_START
       
       #include "XGameRuntimeInit.h" // For Gaming Runtime 
       #include "xsapi-c\services_c.h"  // For XSAPI
       // When using Unreal Engine 4.15 or later
       THIRD_PARTY_INCLUDES_END
   ```
3. Intégrese con las llamadas de servicio. Vea los ejemplos siguientes:

* Procedimientos: procedimiento recomendado para que un usuario inicie sesión
* Actualización de logros administrados por el título

### Creación de un producto en Partner Center

Antes de poder probar la funcionalidad de los servicios de XBOX o publicar un juego en Microsoft Store, debe crear su producto habilitado para los servicios de XBOX en Partner Center. Para obtener más información sobre Partner Center, consulte Configuración de una aplicación o un juego en Partner Center, para asociados administrados.

### Creación de un archivo MicrosoftGame.config para su juego

Para que el juego inicie sesión en los servicios de XBOX, debe incluir un archivo **MicrosoftGame.config** en el paquete del juego y rellenar los campos "MSAAppId" y "TitleId" con los valores del proyecto de Partner Center que creó en el paso anterior. La manera más sencilla de crear el archivo de configuración es usar el [Editor de MicrosoftGame.config](/build/core-features/common/game-config/MicrosoftGameConfig-Editor). Para obtener más información sobre el archivo MicrosoftGame.config, consulte [Información general de MicrosoftGame.config](/build/core-features/common/game-config/MicrosoftGameConfig-Overview).

<Note>
  Asegúrese de que el archivo MicrosoftGame.config se coloque en el mismo directorio que contiene el archivo ejecutable principal de su juego.
</Note>

### Creación y registro del paquete de su juego

Para iniciar sesión en los servicios de XBOX desde su juego y probar la integración de los servicios, debe crear un paquete y registrarlo.

1. Acceda al cuadro de diálogo de empaquetado seleccionando **File** > **Package Project** > **Windows** > **Windows (64-bit)**.
2. Elija una carpeta para la salida de la compilación en el cuadro de diálogo del **Explorador de archivos** y, a continuación, seleccione **Select Folder**.
3. Inicie su juego con wdapp.
   ```cpp theme={null}
       wdapp launch {full path to the game's executable in the same directory containing the MicrosoftGame.Config file}
   ```
4. Como alternativa, puede registrar el paquete con wdapp y, a continuación, iniciar el juego desde el menú Inicio.
   ```cpp theme={null}
       wdapp register {full path to the directory containing the MicrosoftGame.Config file}
   ```

<Note>
  Hacer doble clic directamente en el ejecutable no funcionará para iniciar sesión en los servicios de XBOX.
</Note>

## Consulte también

[Solución de problemas de inicio de sesión y sandboxes](/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes)


## Related topics

- [Uso del GDK con Unreal Engine](/es/build/gdk-and-engines/unreal/unreal.md)
- [Integración del GDK con un motor personalizado de C/C++](/es/build/gdk-and-engines/custom-engine.md)
- [Información general del complemento GSDK de Unreal de PlayFab](/es/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/index.md)
- [Notas de la versión de PlayFab OnlineSubsystem para Unreal Engine](/es/services/playfab/multiplayer/networking/unreal-release-notes.md)
- [Uso del GDK con Unity, Unreal y otros motores](/es/build/gdk-and-engines/gdk-and-engines.md)