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

​

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

​

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
       PublicDefinitions.Add("_GAMING_DESKTOP");  // For Unreal 4.12 or earlier, use "Definitions.Add()" instead
   
3. Agregue las siguientes rutas de inclusión
       // 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
       // 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

​

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

​

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

​

Creación y registro del paquete de su juego

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.
       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.
       wdapp register {full path to the directory containing the MicrosoftGame.Config file}
   

​

Consulte también