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

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

> Intégrez le GDK XBOX aux builds Unreal Engine antérieurs à la version 4.26 en modifiant Build.cs, en ajoutant manuellement les chemins d'inclusion et de bibliothèque, et en lançant le jeu avec wdapp.

Utilisez cette rubrique si vous préparez votre jeu en vue de sa publication sur le Microsoft Store sur PC et que votre jeu utilise une version d'Unreal Engine antérieure à la version 4.26.

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

Si vous utilisez Unreal Engine version 4.26 ou ultérieure, consultez [Bien démarrer avec Unreal sur PC](/fr/build/gdk-and-engines/unreal/unreal).

Si vous utilisez Unreal Engine version 4.25 ou antérieure et que vous ne pouvez pas effectuer la mise à niveau vers la version 4.26 ou ultérieure, vous pouvez tout de même intégrer les expériences clés de l'écosystème XBOX à l'aide des bibliothèques d'importation du Gaming Runtime et de l'API XBOX Services (XSAPI).

Ces bibliothèques d'importation permettent aux jeux d'appeler directement les API du Gaming Runtime et XSAPI, sans avoir à ajouter une plateforme cible GDK au projet de jeu.

### 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**
   ```csharp theme={null}
       PublicDefinitions.Add("_GAMING_DESKTOP");  // For Unreal 4.12 or earlier, use "Definitions.Add()" instead
   ```
3. Ajoutez les chemins d'inclusion suivants
   ```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");
   ```

> 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
   ```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");
   ```

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

<Note>
  Les chemins d'inclusion et de bibliothèque peuvent être différents sur votre machine selon la version du GDK et l'emplacement d'installation.
</Note>

### 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
   ```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é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

Avant de pouvoir tester les fonctionnalités des XBOX services ou publier un jeu sur le Microsoft Store, vous devez créer votre produit compatible XBOX services dans Partner Center. Pour plus d'informations sur Partner Center, consultez Configuration d'une application ou d'un jeu dans Partner Center, pour les partenaires gérés.

### Créer un fichier MicrosoftGame.config pour votre jeu

Pour que le jeu puisse se connecter aux XBOX services, vous devez inclure un fichier **MicrosoftGame.config** dans le package du jeu et renseigner les champs "MSAAppId" et "TitleId" avec les valeurs du projet Partner Center que vous avez créé à l'étape précédente. Le moyen le plus simple de créer le fichier de configuration est d'utiliser l'[éditeur MicrosoftGame.config](/fr/build/core-features/common/game-config/MicrosoftGameConfig-Editor). Pour plus d'informations sur le fichier MicrosoftGame.config, consultez [Vue d'ensemble de MicrosoftGame.config](/fr/build/core-features/common/game-config/MicrosoftGameConfig-Overview).

<Note>
  Assurez-vous que le fichier MicrosoftGame.config se trouve dans le même répertoire que le fichier exécutable principal de votre jeu.
</Note>

### Créer et inscrire le package de votre jeu

Pour vous connecter aux XBOX services depuis votre jeu et tester l'intégration des services, vous devez créer un package et l'inscrire.

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

<Note>
  Double-cliquer directement sur l'exécutable ne fonctionnera pas pour la connexion aux XBOX services.
</Note>

## Voir aussi

[Résolution des problèmes de connexion et de sandbox](/fr/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes)


## Related topics

- [Utiliser le GDK avec Unreal Engine](/fr/build/gdk-and-engines/unreal/unreal.md)
- [Vue d'ensemble du plug-in PlayFab Unreal GSDK](/fr/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/index.md)
- [Déployer un serveur Unreal Linux dans le cloud MPS](/fr/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/setting-up-a-linux-dedicated-server-on-playfab.md)
- [Intégrer le plug-in PlayFab de la marketplace Unreal Engine](/fr/services/playfab/multiplayer/networking/party-unreal-engine-oss-playfab-plugin-integration.md)
- [Utiliser le GDK avec Unity, Unreal et d'autres moteurs](/fr/build/gdk-and-engines/gdk-and-engines.md)