Intégrer le GDK à un projet Unreal Engine antérieur à la version 4.26

​

Utilisation d’une version antérieure d’Unreal Engine (antérieure à la version 4.26)

​

Ajouter les en-têtes et les bibliothèques d’importation pour le Gaming Runtime et XSAPI

1. Recherchez le fichier de build de votre projet Unreal : /Source/(ProjectName)/(ProjectName).Build.cs
2. Ajoutez la ligne ci-dessous pour définir la macro _GAMING_DESKTOP
       PublicDefinitions.Add("_GAMING_DESKTOP");  // For Unreal 4.12 or earlier, use "Definitions.Add()" instead
   
3. Ajoutez les chemins d’inclusion suivants
       // 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");
   

Pour le Microsoft GDK (juin 2024) ou antérieur, utilisez : C:\Program Files (x86)\Microsoft GDK\230300\GRDK\ExtensionLibraries\Xbox.Services.API.C\DesignTime\CommonConfiguration\Neutral\Include

1. Ajoutez les chemins de bibliothèque suivants pour les bibliothèques d’importation
       // 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");
   

Pour le Microsoft GDK (juin 2024) ou antérieur, utilisez : 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

​

Accéder au Gaming Runtime et à XSAPI à partir de fichiers de code C++

1. Déterminez où vous souhaitez ajouter l’intégration pour des éléments comme la connexion et le déblocage des succès
2. Ajoutez les en-têtes pour le Gaming Runtime et 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égrez les appels de service. Consultez les exemples ci-dessous :

• Procédure : bonne pratique pour connecter un utilisateur
• Mise à jour des succès gérés par le titre

​

Création d’un produit dans Partner Center

​

Créer un fichier MicrosoftGame.config pour votre jeu

​

Créer et inscrire le package de votre jeu

1. Accédez à la boîte de dialogue d’empaquetage en sélectionnant File > Package Project > Windows > Windows (64-bit).
2. Choisissez un dossier pour la sortie de build dans la boîte de dialogue Explorateur de fichiers, puis sélectionnez Sélectionner un dossier.
3. Lancez votre jeu avec wdapp.
       wdapp launch {full path to the game's executable in the same directory containing the MicrosoftGame.Config file}
   
4. Vous pouvez également inscrire le package avec wdapp, puis lancer le jeu depuis le menu Démarrer.
       wdapp register {full path to the directory containing the MicrosoftGame.Config file}
   

​

Voir aussi