Skip to main content

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 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.
¿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 para conocer las novedades de los complementos del GDK disponibles públicamente en Unreal Engine 5.8 y las distintas formas de adquirirlos.
Los complementos de Microsoft GDK para Unreal Engine se introdujeron en Unreal Engine 5.7. 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 y del código fuente de Unreal Engine en 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. 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 de Epic Games.

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 (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 (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 o del código fuente de Unreal Engine en 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. 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. Tras la aprobación, obtendrá acceso al código fuente de Unreal Engine que incluye las GDK Platform Extensions.
Para Unreal Engine 5.7, es necesario unirse a un programa para desarrolladores de XBOX 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.
Los complementos clave del GDK que debe tener en cuenta son los siguientes. 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 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.
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.
Los complementos adicionales del GDK que proporcionan más funcionalidad son los siguientes. 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.
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.
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 de Epic Games.
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.

Compatibilidad entre el GDK y el motor

Cada versión de Unreal Engine incluye notas de la versión 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. 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:
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:
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. 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. 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. Para obtener más información, consulte Compilación de Unreal Engine desde el código fuente.
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 de Epic Games.

Adición de los complementos del GDK a su proyecto

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).
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) 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. Además de habilitar los complementos en el Unreal Editor, asegúrese de que cualquier destino de compilación que defina también habilite estos complementos para la compilación. Considere el siguiente ejemplo para su destino de compilación de Windows.
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 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. Cada plataforma y complemento contiene un conjunto similar de opciones que le ayudan a configurar su archivo MicrosoftGame.config y la configuración de empaquetado. Figura 6. Configuración del proyecto de los complementos del GDK, parte 1. 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. 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. Más allá de la configuración de Platform y Plugin, asegúrese de que su DefaultEngine.ini 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.
Para especificar cualquier invalidación en el archivo .ini de motor de la plataforma (por ejemplo, WindowsEngine.ini), modifique ese archivo manualmente.
Para usar el complemento GDK Package Chunk Install para Intelligent Delivery, asegúrese de especificarlo en su archivo .ini.

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 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.
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.
Para obtener más información, consulte Configuración de los logros administrados por el título en el Centro de partners. Además de configurar su DefaultEngine.ini y de configurar su archivo Achievements.json, pase GDK_SUBSYSTEM en sus llamadas a Online::GetSubsystem().
El Online Subsystem GDK usa Microsoft Azure PlayFab Party directamente a través de los complementos PlayFabParty del GDK como Socket Subsystem.

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. Para obtener más información sobre las Visual Studio Tools for Unreal Engine, consulte Instalación de Visual Studio Tools for Unreal Engine.

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

Use la Unreal Automation Tool 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.
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. 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. 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.

Pruebas del proyecto

También puede usar la Unreal Automation Tool para implementar e iniciar su compilación. Para hacerlo, use estas marcas.
Para probar su compilación independiente, use la configuración integrada de Launch como parte del Project Launcher en el Unreal Editor. Figura 11. Ejemplo de perfil del Project Launcher. 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. Al usar los complementos de Microsoft GDK para Unreal Engine, puede usar Play In Editor (PIE) para probar su juego con los servicios de XBOX directamente desde el editor en la plataforma Win64.
Hay algunas limitaciones conocidas con la plataforma WinGDK y la compatibilidad con PIE. Recomendamos pruebas con compilaciones independientes y empaquetadas para esta plataforma.

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. 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. Para la configuración del lado del motor y ejemplos de línea de comandos, consulte Remote Windows Deployment en 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.

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

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.

Consulte también

Última modificación el 1 de septiembre de 2026