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

# Uso del GDK con Unreal Engine

> Integre los complementos y las extensiones de plataforma del GDK en Unreal Engine 5.7+ para dirigirse a Win64, XBOX Series X|S y XBOX One con compilaciones de PC unificadas y un procesamiento (cook) más rápido.

## Información general

Este artículo describe cómo integrar los componentes de Microsoft Game Development Kit (GDK) en su proyecto de Unreal Engine. Abarca los distintos tipos de [complementos de Unreal Engine](https://aka.ms/ue_plugins) y extensiones de plataforma, cómo configurarlos y qué funcionalidad se incluye en los complementos y extensiones proporcionados.

Epic Games mantiene y distribuye las GDK Platform Extensions y los complementos asociados.

<Tip>
  **¿Es nuevo en el desarrollo para XBOX con Unreal Engine?** Consulte [Creación de juegos de XBOX con los nuevos complementos del GDK de Unreal Engine](/build/gdk-and-engines/unreal/unreal-xbox-pc) para conocer las novedades de los complementos del GDK disponibles públicamente en Unreal Engine 5.8 y las distintas formas de adquirirlos.
</Tip>

<Warning>
  Los complementos de Microsoft GDK para Unreal Engine se introdujeron en [Unreal Engine 5.7](https://aka.ms/ue_release_notes). En Unreal Engine 5.7, estos complementos forman parte de las GDK Platform Extensions y requieren una solicitud de acceso independiente. A partir de **Unreal Engine 5.8**, los mismos complementos están **disponibles públicamente** con el motor a través del [Epic Games Launcher](https://aka.ms/ue_download) y del [código fuente de Unreal Engine en GitHub](https://www.unrealengine.com/ue-on-github). No se necesita ninguna solicitud de acceso independiente. Para obtener más información, consulte [Creación de juegos de XBOX con los nuevos complementos del GDK de Unreal Engine](/build/gdk-and-engines/unreal/unreal-xbox-pc). *WinGDK ya no recibe actualizaciones de características y se considera una plataforma heredada*. Epic Games proporciona una herramienta de migración para portar los proyectos existentes de WinGDK a Win64. Para obtener más información, consulte la [documentación del GDK](https://aka.ms/ue_gdk_docs_plugins) de Epic Games.
</Warning>

## Requisitos previos

Para usar las GDK Platform Extensions y los complementos del GDK para Unreal Engine, necesita los siguientes requisitos previos.

* [Unreal Engine 4.27 o posterior](https://aka.ms/ue_download) (se recomienda Unreal Engine 5.8 o posterior; los complementos del GDK están disponibles públicamente a partir de la versión 5.8, o disponibles con la versión 5.7 a través de las GDK Platform Extensions)
* Visual Studio 2019 (16.9) o posterior
* Windows SDK (22000 o posterior)
* Windows 10 (1809 o posterior) o Windows 11
* [Microsoft GDK](https://aka.ms/gdkdl) (instálelo con `winget install Microsoft.GDK`)

## Complementos de Microsoft GDK para Unreal Engine

Cada complemento del GDK proporciona funcionalidades diferentes cuando lo habilita para su proyecto. Los complementos de esta sección forman parte de las extensiones de plataforma del GDK que distribuye Epic Games.

A partir de **Unreal Engine 5.8**, los complementos del GDK están disponibles públicamente con el motor. Puede adquirirlos a través del [Epic Games Launcher](https://aka.ms/ue_download) o del [código fuente de Unreal Engine en GitHub](https://www.unrealengine.com/ue-on-github). No se necesita ninguna solicitud de acceso independiente. Para obtener una guía sobre las distintas formas de adquirir estos complementos, consulte [Creación de juegos de XBOX con los nuevos complementos del GDK de Unreal Engine](/build/gdk-and-engines/unreal/unreal-xbox-pc).

En **Unreal Engine 5.7**, existen los mismos complementos, pero forman parte de las GDK Platform Extensions, que requieren pertenecer a un programa para desarrolladores de XBOX, como ID\@XBOX, y una solicitud de acceso independiente. Solicite acceso mediante [este formulario de solicitud de acceso](https://aka.ms/ue_gdk_access). Tras la aprobación, obtendrá acceso al código fuente de Unreal Engine que incluye las GDK Platform Extensions.

<Note>
  Para Unreal Engine 5.7, es necesario unirse a un [programa para desarrolladores de XBOX](https://aka.ms/gdk_id) y solicitar acceso a los complementos del GDK y a las GDK Platform Extensions para el desarrollo en PC, XBOX Series X|S y XBOX One. Este requisito de acceso se ha eliminado en Unreal Engine 5.8 y versiones posteriores, donde los complementos están disponibles públicamente. Si tiene algún problema, póngase en contacto con su representante de Microsoft para obtener ayuda.
</Note>

Los complementos clave del GDK que debe tener en cuenta son los siguientes.

| Nombre del complemento                          | Compatibilidad de plataforma              | Versión mínima del motor       |
| :---------------------------------------------- | :---------------------------------------- | :----------------------------- |
| Microsoft GDK Runtime Plug-in for Unreal Engine | Win64                                     | Unreal Engine 5.7 o posterior  |
| Microsoft GDK Store Plug-in for Unreal Engine   | Win64                                     | Unreal Engine 5.7 o posterior  |
| Online Subsystem GDK                            | Win64, WinGDK, XBOX One, XBOX Series X\|S | Unreal Engine 4.27 o posterior |

**Microsoft GDK Runtime Plug-in for Unreal Engine:** proporciona acceso a la funcionalidad en tiempo de ejecución del GDK, como los guardados de juego compatibles con XBOX y la selección de usuario de XBOX. En Unreal Engine 5.7, este complemento se encuentra en la carpeta de las GDK Platform Extensions como `MSGamingRuntime`. En Unreal Engine 5.8, se ha movido a `Engine\Plugins\Runtime\Windows\MSGamingRuntime`.

**Microsoft GDK Store Plug-in for Unreal Engine:** proporciona la generación automática de paquetes .msixvc para su envío a la aplicación XBOX para PC. En Unreal Engine 5.7, este complemento se encuentra en la carpeta de las GDK Platform Extensions como `MSGameStore`. En Unreal Engine 5.8, se ha movido a `Engine\Plugins\Runtime\Windows\MSGameStore`.

**Online Subsystem GDK:** proporciona la integración del GDK con el [Online Subsystem](https://aka.ms/ue_oss) de Unreal. Este complemento es una capa de abstracción del motor que proporciona llamadas de interfaz comunes para características clave como logros, amigos y emparejamiento (matchmaking). En Unreal Engine 5.7, este complemento se encuentra en todas las carpetas de plataforma, incluida la carpeta GDK para la compatibilidad con Win64, como `OnlineSubsystemGDK`. En Unreal Engine 5.8, el complemento de Win64 se ha movido a `Engine\Plugins\Online\Microsoft\OnlineSubsystemGDK`.

<Note>
  Si ya ha habilitado estos complementos para su proyecto, los nombres de los complementos siguen siendo los mismos entre Unreal Engine 5.7 y 5.8. La configuración del proyecto se conserva al actualizar. Las rutas de las carpetas solo importan si navega directamente por el código fuente del motor.
</Note>

Los complementos adicionales del GDK que proporcionan más funcionalidad son los siguientes.

| Nombre del complemento      | Compatibilidad de plataforma              | Versión mínima del motor      |
| :-------------------------- | :---------------------------------------- | :---------------------------- |
| Game Input Base             | Win64, WinGDK, XBOX One, XBOX Series X\|S | Unreal Engine 5.4 o posterior |
| Game Input (Windows)        | Win64, WinGDK                             | Unreal Engine 5.4 o posterior |
| XBOX Common Game Input      | XBOX One, XBOX Series X\|S                | Unreal Engine 5.4 o posterior |
| GDK Package Chunk Installer | Win64, WinGDK, XBOX One, XBOX Series X\|S | Unreal Engine 5.7 o posterior |
| GDK Virtual Keyboard        | Win64, WinGDK, XBOX One, XBOX Series X\|S | Unreal Engine 5.7 o posterior |
| Windows Virtual Keyboard    | Win64                                     | Unreal Engine 5.7 o posterior |

Los complementos Game Input (Windows), Game Input Base y XBOX Common Game Input proporcionan la integración con la funcionalidad de `GameInput` dentro de Unreal Engine. Estos complementos se estructuran de la siguiente manera.

* GameInput (nombre descriptivo: Game Input Base)
  * Contiene la funcionalidad principal y una interfaz que implementan los complementos que aparecen más abajo en esta lista
    * Plataforma: Win64
      * GameInput\_WinGDK, GameInput\_XB1 y GameInput\_XSX extienden el complemento GameInput para agregar compatibilidad con sus plataformas respectivas (sin diferencias de código respecto al elemento primario)
* GameInputWindows (nombre descriptivo: Game Input (Windows))
  * Depende de GameInput e implementa la interfaz del complemento GameInput
  * Plataforma: Win64
    * GameInputWindows\_WinGDK extiende GameInputWindows para agregar compatibilidad con la plataforma WinGDK (sin diferencias de código respecto al elemento primario)
* XboxCommonGDKGameInput (nombre descriptivo: XBOX Common GameInput)
  * Depende de GameInput e implementa una interfaz del complemento GameInput
  * Plataforma: ninguna especificada
  * Equivalente a GameInputWindows, pero para las dos plataformas de XBOX y con una implementación de interfaz diferente (debido a las diferencias de GameInput entre plataformas)
  * XboxCommonGDKGameInput\_XB1 y XboxCommonGDKGameInput\_XSX extienden XboxCommonGDKGameInput para agregar compatibilidad con sus plataformas respectivas (sin diferencias de código respecto al elemento primario)

El complemento GDK Package Chunk Installer proporciona funcionalidad adicional para aplicar Intelligent Delivery al compilar el paquete del GDK. En Unreal Engine 5.7, el complemento compatible con Win64 se encuentra en la carpeta `Engine\Platforms\GDK\Plugins`. En Unreal Engine 5.8, se ha movido a `Engine\Plugins\Runtime\Microsoft\GDKPackageChunkInstall`. Los complementos específicos de plataforma con el sufijo de plataforma para WinGDK, XBOX One y XBOX Series X|S existen dentro de sus carpetas de plataforma respectivas.

El complemento GDK Virtual Keyboard y el complemento Windows Virtual Keyboard proporcionan funcionalidad para invocar un teclado virtual como parte de su juego. Esta funcionalidad es especialmente importante cuando se consideran escenarios de mando en dispositivos portátiles.

El complemento GDK Virtual Keyboard usa una API específica del GDK para habilitar esta funcionalidad. En Unreal Engine 5.7, el complemento compatible con Win64 se encuentra en la carpeta `Engine\Platforms\GDK\Plugins`. En Unreal Engine 5.8, se ha movido a `Engine\Plugins\Runtime\Microsoft\GDKVirtualKeyboard`. El complemento Windows Virtual Keyboard se encuentra en `Engine\Plugins\Runtime\Windows\WinVirtualKeyboard` en Unreal Engine 5.8. Los complementos específicos de plataforma con el sufijo de plataforma para WinGDK (\_WinGDK), XBOX One (\_XB1) y XBOX Series X|S (\_XSX) existen dentro de sus carpetas de plataforma respectivas.

## Unreal Engine y las GDK Platform Extensions

El código específico del GDK dentro de Unreal Engine forma parte de las GDK Platform Extensions. Estas extensiones se agregan al código fuente base del motor y le permiten compilar su juego mediante el GDK para PC, XBOX One y XBOX Series X|S. Las extensiones incluyen un conjunto de plataformas del GDK y de complementos del GDK que funcionan con el motor para extender la funcionalidad necesaria.

En **Unreal Engine 5.7**, las GDK Platform Extensions son una descarga independiente que requiere la pertenencia a un programa para desarrolladores de XBOX. Necesita el GDK con extensiones de XBOX (GDKx) independientemente de su plataforma de destino. Las extensiones incluyen código fuente en `Engine\Platforms` con las siguientes plataformas específicas del GDK:

* WinGDK
* XBOX One
* XBOX Series X|S

En **Unreal Engine 5.8**, los complementos del GDK para PC (Win64) están disponibles públicamente directamente en el motor en `Engine\Plugins\`. La descarga de las GDK Platform Extensions ya no es necesaria para el desarrollo exclusivo para PC. El desarrollo para consolas XBOX (XBOX One, XBOX Series X|S) sigue requiriendo las GDK Platform Extensions.

<Warning>
  No use la plataforma WinGDK. Es una opción heredada. Use los complementos Microsoft GDK Store y Runtime para la plataforma Win64 en todos los nuevos proyectos del GDK para PC.
</Warning>

Las carpetas GDK y XboxCommon proporcionan código compartido entre plataformas. El código de GDK se comparte entre todas las plataformas, y el código de XboxCommon se comparte entre las plataformas XBOX One y XBOX Series X|S. Puede encontrar los complementos de cada plataforma en la carpeta `Plugins` dentro de cada plataforma en la descarga de las GDK Platform Extensions.

Para obtener más información sobre las configuraciones de XBOX One y XBOX Series X|S, consulte la [documentación del GDK](https://aka.ms/ue_gdk_docs) de Epic Games.

<Note>
  Si usa Unreal Engine 4, aparece **XboxOneGDK** en lugar de **XB1**. Epic Games cambió el nombre de esta plataforma a **XB1** en Unreal Engine 5.
</Note>

## Compatibilidad entre el GDK y el motor

Cada versión de Unreal Engine incluye [notas de la versión](https://aka.ms/ue_release_notes) que especifican qué versión principal del GDK admite el Unreal Editor. El equipo de Unreal Engine prueba esta versión para validar la compatibilidad con el motor. Por ejemplo:

**Figura 1. Notas de la versión de Unreal Engine.**

<img src="https://mintcdn.com/microsoft-4404708b/hprF_XHEe0cnRr8N/images/unreal-guide/ue-relnote.webp?fit=max&auto=format&n=hprF_XHEe0cnRr8N&q=85&s=97232127aaecf514728d865ba978f289" alt="Notas de la versión de Unreal Engine." width="2206" height="927" data-path="images/unreal-guide/ue-relnote.webp" />

El archivo de configuración que define esta compatibilidad y el intervalo de versiones del GDK admitidas es el archivo `GDK_SDK.json`. La ubicación de este archivo varía según la versión del motor:

* **Unreal Engine 5.7 y anteriores:** `Engine\Platforms\GDK\Config\GDK_SDK.json`
* **Unreal Engine 5.8:** `Engine\Config\Microsoft\GDK_SDK.json`

Por ejemplo, en Unreal Engine 5.7:

```JSON theme={null}
{
    "MainVersion": "250402",
    "MinVersion": "240604",
    "MaxVersion": "250499",
}
```

En Unreal Engine 5.8, los nombres de los campos han cambiado ligeramente, y el intervalo admitido ahora incluye el GDK de abril de 2026:

```JSON theme={null}
{
    "MainGDKVersion": "260401",
    "MinGDKVersion": "250404",
    "MaxGDKVersion": "260499",
}
```

Si modifica la versión del GDK en este archivo, puede usar GDK más recientes. Este enfoque le permite adoptar un GDK más reciente que una versión de Unreal Engine. Aunque el equipo de Unreal Engine se esfuerza por evitar problemas de compatibilidad, algunos GDK podrían requerir modificaciones del motor para funcionar. No hay compatibilidad garantizada cuando modifica su versión máxima más allá de lo que Epic Games definió en la versión publicada de este archivo.

## Actualizaciones del proyecto para trabajar con las GDK Platform Extensions

Después de adquirir el código fuente de las GDK Platform Extensions, actualice los archivos de su proyecto para acceder a las plataformas específicas del GDK en su IDE. Para obtener más información, consulte [Actualizar archivos de proyecto](https://aka.ms/ue_ide). Ejecute el archivo GenerateProjectFiles.bat en el directorio raíz de su versión del motor.

Cuando termine este paso, verá opciones para compilar para cada plataforma en la lista desplegable **IDE Solution Platform**.

**Figura 2. Plataformas del GDK de Unreal Engine en el IDE de Visual Studio.**

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/unreal-guide/ue-vs-ide.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=c2044c7965d2ec3262f3677571832cb3" alt="Plataformas del GDK de Unreal Engine en el IDE de Visual Studio." width="1300" height="756" data-path="images/unreal-guide/ue-vs-ide.png" />

Después de recompilar el editor, verá estas opciones y configuraciones de plataforma disponibles en el Unreal Editor. Para probar esta característica, seleccione la lista desplegable **Platforms** y confirme que **WinGDK**, **XB1** y **XSX** existen en la lista.

**Figura 3. Plataformas del GDK de Unreal Engine en el Unreal Editor.**

<img src="https://mintcdn.com/microsoft-4404708b/hprF_XHEe0cnRr8N/images/unreal-guide/ue-platforms-devices.webp?fit=max&auto=format&n=hprF_XHEe0cnRr8N&q=85&s=b0d3023cf8c77dd71a91644c6162a233" alt="Plataformas del GDK de Unreal Engine en el Unreal Editor." width="1162" height="805" data-path="images/unreal-guide/ue-platforms-devices.webp" />

Para obtener más información, consulte [Compilación de Unreal Engine desde el código fuente](https://aka.ms/ue_build_source).

<Warning>
  Los complementos de Microsoft GDK para Unreal Engine le permiten compilar juegos del GDK directamente en la plataforma Win64. Este enfoque crea una ruta de compilación de PC unificada entre varias tiendas. Elimina los pasos adicionales de procesamiento (cook) y las incompatibilidades de complementos que se producen con la plataforma heredada WinGDK. *Los complementos de Microsoft GDK para Unreal Engine son el futuro de la integración del GDK para PC dentro de Unreal Engine*. Para obtener más información sobre ellos, y sobre cómo migrar su proyecto de WinGDK existente a los complementos del GDK de Win64 mediante un script de migración proporcionado por Epic Games, consulte la [documentación del GDK](https://aka.ms/ue_gdk_docs_plugins) de Epic Games.
</Warning>

## Adición de los complementos del GDK a su proyecto

<Note>
  Un subconjunto de los complementos del GDK se habilita automáticamente de forma predeterminada para XBOX One y XBOX Series X|S. Para obtener más información, consulte `UEBuildXboxCommon.cs` en el código fuente de la Unreal Build Tool (UBT).
</Note>

Después de adquirir y configurar las GDK Platform Extensions, puede empezar a configurar su proyecto para comenzar a usar el GDK. Cada complemento está disponible en la [interfaz de complementos (Plugins UI)](https://aka.ms/ue_plugins) del Unreal Editor, en el menú Edit.

Al seleccionar un complemento, asegúrese de activar la casilla para habilitarlo. Reinicie el editor después de habilitar los complementos para asegurarse de que funcionan correctamente.

**Figura 4. Ejemplo de complemento del GDK habilitado en el Unreal Editor.**

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/unreal-guide/ue-plugin.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=3dcb435a841bc017e780f145109d7f7e" alt="Ejemplo de complemento del GDK habilitado en el Unreal Editor." width="463" height="81" data-path="images/unreal-guide/ue-plugin.png" />

Además de habilitar los complementos en el Unreal Editor, asegúrese de que cualquier [destino de compilación](https://aka.ms/ue_ubt_ref) que defina también habilite estos complementos para la compilación. Considere el siguiente ejemplo para su destino de compilación de Windows.

```csharp theme={null}
EnablePlugins.AddRange([
    "MSGameStore",
    "MSGamingRuntime",
    "OnlineSubsystemGDK",
]);
```

Para obtener información sobre la configuración de destinos de compilación con los complementos del GDK para Unreal Engine, consulte la [documentación del GDK](https://aka.ms/ue_gdk_docs_plugins) de Epic Games.

## Configuración de los complementos del GDK con datos específicos del título

Después de configurar los complementos del GDK y las extensiones de plataforma del GDK, actualice la configuración de Platform y Plugin en el menú **Project Settings**.

Puede encontrar las plataformas XBOX One y XBOX Series X|S en **Platform Settings**. Los complementos de Microsoft GDK para Unreal Engine están en **Plugin Settings**.

**Figura 5. Configuración de Platform y Plugins del GDK de Unreal Engine.**

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/unreal-guide/ue-settings-platform-plugin.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=31cab8f73b9af5b185e4cdb6fa4e610d" alt="Configuración de Platform y Plugins del GDK de Unreal Engine." width="405" height="396" data-path="images/unreal-guide/ue-settings-platform-plugin.png" />

Cada plataforma y complemento contiene un conjunto similar de opciones que le ayudan a configurar su archivo [MicrosoftGame.config](https://aka.ms/gdk_gameconfig) y la configuración de empaquetado.

**Figura 6. Configuración del proyecto de los complementos del GDK, parte 1.**

<img src="https://mintcdn.com/microsoft-4404708b/hprF_XHEe0cnRr8N/images/unreal-guide/ue-settings1.webp?fit=max&auto=format&n=hprF_XHEe0cnRr8N&q=85&s=f715e96b6075d139edc0210e096e5abd" alt="Configuración del proyecto de los complementos del GDK, parte 1." width="2140" height="1165" data-path="images/unreal-guide/ue-settings1.webp" />

Su MicrosoftGame.config local necesita la información de su producto, como `Title ID` y `Store ID`, para funcionar correctamente con el GDK y los servicios de XBOX. Use la opción **Associate with Partner Center** para iniciar sesión con una cuenta Microsoft que tenga acceso al [Centro de partners de Microsoft](https://aka.ms/gdk_partner_center). Esta opción agrega automáticamente los detalles de su producto al archivo MicrosoftGame.config local, de modo que no necesita introducirlos manualmente.

Además de la configuración de MicrosoftGame.config, configure las opciones de empaquetado e instalación.

**Figura 7. Configuración del proyecto de los complementos del GDK, parte 2.**

<img src="https://mintcdn.com/microsoft-4404708b/hprF_XHEe0cnRr8N/images/unreal-guide/ue-settings2.webp?fit=max&auto=format&n=hprF_XHEe0cnRr8N&q=85&s=1427dca9d4722be766b6eccab1b095a6" alt="Configuración del proyecto de los complementos del GDK, parte 2." width="2142" height="1164" data-path="images/unreal-guide/ue-settings2.webp" />

Más allá de la configuración de Platform y Plugin, asegúrese de que su [DefaultEngine.ini](https://aka.ms/ue_configfiles) tenga la información necesaria. Las opciones del complemento MS Gaming (PC GDK) escriben automáticamente esta información en la sección. Este es un ejemplo del DefaultEngine.ini que usa los complementos del GDK como referencia.

<Note>
  Para especificar cualquier invalidación en el archivo .ini de motor de la plataforma (por ejemplo, WindowsEngine.ini), modifique ese archivo manualmente.
</Note>

```ini theme={null}
[/Script/MSGamingSupport.MSGamingSettings]
TitleId=00000000
PrimaryServiceConfigId=00000000-0000-0000-0000-000000000000
ProductId=ProductValue
ContentId=ContentIDValue
PackageName=PackageName
StoreId=0000000000
DefaultDisplayName=Test Game
PublisherName=CN=PublisherValue
PublisherDisplayName=Test Company
EKBID=EKBIDValue
MSAAppId=MSAppIdValue
bRequireXboxLive=True 
bUseSimplifiedUserModel=True 
ManifestVersion=1
```

Para usar el complemento GDK Package Chunk Install para Intelligent Delivery, asegúrese de especificarlo en su archivo .ini.

```ini theme={null}
[StreamingInstall]
DefaultProviderName=GDKPackageChunkInstall
```

## Uso del Online Subsystem GDK

El complemento Online Subsystem GDK proporciona una abstracción del motor de las API clave de los servicios de XBOX para simplificar el código del juego escrito para realizar acciones similares en muchas tiendas y plataformas (por ejemplo, inicio de sesión, compras en la tienda, logros, amigos, emparejamiento). Use el [Online Subsystem](https://aka.ms/ue_oss) si está creando un juego con el GDK.

Para configurar el Online Subsystem GDK, edite su DefaultEngine.ini (o el archivo .ini de motor de la plataforma) con detalles adicionales para asegurarse de que funciona correctamente para su juego. Este es un ejemplo para el WindowsEngine.ini.

```ini theme={null}
[OnlineSubsystem]
DefaultPlatformService=GDK

[OnlineSubsystemGDK] 
eEnabled=True
AchievementMode=2017
; to specify using title-managed achievements, must match configuration in Partner Center
StatsMode=2013
; to specify using event-based stats, must match configuration in Partner Center
PrimaryServiceConfigId=00000000-0000-0000-0000-000000000000
```

Los nombres de logros usados en Unreal Engine deben asignarse a los identificadores de logros usados en el Centro de partners. Para asignar los nombres de logros usados en Unreal Engine, cree un archivo llamado `Achievements.json` en el directorio platforms\GDK\Config\OSS\ de su proyecto (tenga en cuenta que la ruta podría no existir y que podría tener que crearla usted mismo). `Achievements.json` contiene una asignación de los nombres de logros a sus identificadores del Centro de partners. Por ejemplo, si su proyecto tiene 10 logros llamados achievement 1 a achievement 10, `Achievements.json` tiene este aspecto.

```json theme={null}
{
    "AchievementEventName" : "NotUsedInAchievement2017",
    "AchievementMap" :
    {
      "achievement 1" : 1,
      "achievement 2" : 2,
      "achievement 3" : 3,
      "achievement 4" : 4,
      "achievement 5" : 5,
      "achievement 6" : 6,
      "achievement 7" : 7,
      "achievement 8" : 8,
      "achievement 9" : 9,
      "achievement 10" : 10
    }
}
```

Para obtener más información, consulte [Configuración de los logros administrados por el título en el Centro de partners](https://aka.ms/gdk_tm_achievements).

Además de configurar su DefaultEngine.ini y de configurar su archivo `Achievements.json`, pase `GDK_SUBSYSTEM` en sus llamadas a `Online::GetSubsystem()`.

<Note>
  El Online Subsystem GDK usa Microsoft Azure PlayFab Party directamente a través de los complementos PlayFabParty del GDK como Socket Subsystem.
</Note>

## Uso de Visual Studio y Unreal Engine

Visual Studio proporciona funcionalidad adicional, como parte del instalador de Visual Studio, para una mejor integración con Unreal Engine. Esta funcionalidad se incluye en la carga de trabajo Desarrollo de juegos con C++. Dos componentes de instalación opcionales, denominados *Visual Studio Tools for Unreal Engine* y *Visual Studio debugger tools for Unreal Engine*, proporcionan compatibilidad nativa con `uplugin` y la capacidad de depurar la lógica de Blueprint desde Visual Studio.

**Figura 8. Visual Studio Tools for Unreal Engine en el instalador de Visual Studio.**

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/unreal-guide/ue-vs-install.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=7a8f2139b6f763e7b5104810fd09ea50" alt="Visual Studio Tools for Unreal Engine en el instalador de Visual Studio." width="480" height="678" data-path="images/unreal-guide/ue-vs-install.png" />

Para obtener más información sobre las Visual Studio Tools for Unreal Engine, consulte [Instalación de Visual Studio Tools for Unreal Engine](https://aka.ms/vs_tools_ue).

## Compilación, procesamiento (cook) y empaquetado del proyecto

Use la [Unreal Automation Tool](https://aka.ms/ue_uat) para compilar, procesar (cook) y empaquetar automáticamente su juego para cada plataforma del GDK. Esta herramienta también crea un paquete para su integración de los complementos del GDK mediante la plataforma Win64. Para usar esta herramienta, siga la sintaxis proporcionada.

```bat theme={null}
RunUAT BuildCookRun -project=TestGame -Platform=Win64 -build -cook -stage -pak -archive -archivedirectory=C:\TestGame\ -package
```

Puede compilar, procesar (cook) y empaquetar su juego a través del Unreal Editor. Para conocer las etapas detalladas de este proceso, consulte [Operaciones de compilación: Cook, Package, Deploy y Run](https://aka.ms/ue_build_stages).

Cada plataforma requiere un procesamiento (cook) único de su contenido para asegurarse de que funciona correctamente en la plataforma de destino. Vaya al menú desplegable **Platforms** en el Unreal Editor y seleccione **Cook Content** para la plataforma deseada.

**Figura 9. Opción Cook en el Unreal Editor.**

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/unreal-guide/ue-cook-editor.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=ecbe674a589b50bdd977986236e298ea" alt="Opción Cook en el Unreal Editor." width="633" height="257" data-path="images/unreal-guide/ue-cook-editor.png" />

Para empaquetar su juego en el Unreal Editor, vaya al menú desplegable **Platforms** y, a continuación, seleccione **Package Project** para la plataforma que desee. Esta acción crea un paquete XVC o MSIXVC en el directorio de salida de la compilación.

**Figura 10. Opción Package en el Unreal Editor.**

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/unreal-guide/ue-package-editor.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=bfb686f1de6a09975a9f3ce821da9c9d" alt="Opción Package en el Unreal Editor." width="736" height="246" data-path="images/unreal-guide/ue-package-editor.png" />

## Pruebas del proyecto

También puede usar la Unreal Automation Tool para implementar e iniciar su compilación. Para hacerlo, use estas marcas.

```bat theme={null}
RunUAT BuildCookRun [...]] -package -deploy -run
```

Para probar su compilación independiente, use la configuración integrada de **Launch** como parte del [Project Launcher](https://aka.ms/ue_projectlauncher) en el Unreal Editor.

**Figura 11. Ejemplo de perfil del Project Launcher.**

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/unreal-guide/ue-projectlauncher.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=e67f4920af58c4a43973b7aee78104bb" alt="Ejemplo de perfil del Project Launcher." width="1523" height="1041" data-path="images/unreal-guide/ue-projectlauncher.png" />

Para los paquetes que genere a través de la interfaz de usuario del Unreal Editor, necesita usar las herramientas del GDK para instalarlos e iniciarlos fuera del Unreal Editor. Actualmente, el Project Launcher no admite la instalación e inicio de estos paquetes. Para obtener información sobre cómo realizar esta tarea para títulos del GDK para PC, consulte [Uso de las herramientas de Microsoft Game Development Kit para instalar e iniciar su título de PC](https://aka.ms/gdk_pc_launch).

Al usar los complementos de Microsoft GDK para Unreal Engine, puede usar [Play In Editor (PIE)](https://aka.ms/ue_pie) para probar su juego con los servicios de XBOX directamente desde el editor en la plataforma Win64.

<Note>
  Hay algunas limitaciones conocidas con la plataforma WinGDK y la compatibilidad con PIE. Recomendamos pruebas con compilaciones independientes y empaquetadas para esta plataforma.
</Note>

### Prueba del juego de forma remota mediante las XBOX PC Remote Tools

A partir de Unreal Engine 5.8, Remote Windows Deployment le permite compilar, procesar (cook), implementar e iniciar su juego en un PC con Windows independiente, incluido hardware de Windows en Arm64, directamente desde el Unreal Editor o desde la línea de comandos. Esta característica está respaldada por las [XBOX PC Remote Tools](/tools/tools-pc/xbox-pc-remote-tools). Después de instalar el XBOX PC Toolbox tanto en su equipo de desarrollo como en el dispositivo de destino y emparejarlos, registre el destino en la configuración del motor y, a continuación, selecciónelo en el menú **Launch On** de la barra de herramientas del editor, o pase `-deploy -run -device=<DeviceName>` a `RunUAT BuildCookRun`.

Para conocer los pasos de configuración, consulte la [guía de inicio rápido de las XBOX PC Remote Tools](/tools/tools-pc/xbox-pc-remote-tools/quickstart). Para la configuración del lado del motor y ejemplos de línea de comandos, consulte [Remote Windows Deployment en Unreal Engine](https://dev.epicgames.com/documentation/unreal-engine/remote-windows-deployment-in-unreal-engine) en la documentación de Epic Games.

## Información adicional

### Uso de Microsoft Azure PlayFab con Unreal Engine

Para obtener más información sobre cómo trabajar con PlayFab, que incluye integración directa y complementos para trabajar dentro de Unreal Engine, incluida la compatibilidad con el Online Subsystem, consulte la página [Inicio rápido de PlayFab para Unreal Engine](https://aka.ms/pf_ue_quickstart).

### Detección de dispositivos portátiles de Windows

Unreal Engine 5.7 admite la detección de dispositivos portátiles de Windows mediante `FPlatformMisc::IsDeviceHandheld()`. Esta función devuelve `true` o `false` según el estado del dispositivo.

### Obtención de ayuda

Para obtener soporte técnico o hacer preguntas específicas de Unreal Engine, incluidas las preguntas relacionadas con los complementos de Microsoft GDK para Unreal Engine o las GDK Platform Extensions, consulte el [foro de soporte del GDK de Epic](https://aka.ms/ue_gdk_forums).

Si necesita ayuda con artículos específicos del GDK que no estén relacionados con las integraciones de Unreal Engine, publique sus preguntas en los [foros del GDK de XBOX](https://aka.ms/gdk_xbox_forums).

### Uso de versiones anteriores de Unreal Engine

Si usa Unreal Engine 4.26 o una versión anterior, siga pasos diferentes para dirigirse al GDK. Además, necesita realizar más integración personalizada de las características de plataforma y del empaquetado que con las versiones posteriores de Unreal Engine. Actualice a Unreal Engine 4.27 o posterior para obtener la mejor experiencia.

Para obtener más información sobre el uso del GDK con Unreal Engine 4.26 o versiones anteriores, consulte [Compilación de juegos del GDK para versiones anteriores de Unreal](/build/gdk-and-engines/unreal/unreal-legacy).

## Consulte también

* [Creación de juegos de XBOX con los nuevos complementos del GDK de Unreal Engine](/build/gdk-and-engines/unreal/unreal-xbox-pc)
* [Documentación de los complementos del GDK de Epic Games](https://aka.ms/ue_gdk_docs_plugins)
* Pasos para todos los juegos
