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

# Développement Unreal pour PC : prise en main (versions antérieures)

> Intégrez le GDK XBOX dans les 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 de Unreal Engine antérieure à la version 4.26.

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

Si vous utilisez Unreal Engine version 4.26 ou ultérieure, consultez [Prise en main de Unreal sur PC](/fr-CA/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 principales expériences 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. Trouvez 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 Microsoft GDK (juin 2024) ou une version antérieure, 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 Microsoft GDK (juin 2024) ou une version antérieure, 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 ordinateur selon la version du GDK et l'emplacement d'installation.

### 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éverrouillage 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 : pratique exemplaire 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 avec les XBOX services dans Partner Center. Pour plus de renseignements 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 remplir les champs "MSAAppId" et "TitleId" avec les valeurs du projet Partner Center que vous avez créé à l'étape précédente. La façon la plus simple de créer le fichier de configuration est d'utiliser le [MicrosoftGame.config Editor](/fr-CA/build/core-features/common/game-config/MicrosoftGameConfig-Editor). Pour plus de renseignements sur le fichier MicrosoftGame.config, consultez [Vue d'ensemble de MicrosoftGame.config](/fr-CA/build/core-features/common/game-config/MicrosoftGameConfig-Overview).

> [!NOTE]
>
> Assurez-vous que le fichier MicrosoftGame.config est placé dans le même répertoire que le fichier exécutable principal de votre jeu.

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

Pour vous connecter aux XBOX services à partir de 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 du 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 aussi inscrire le package avec wdapp, puis lancer le jeu à partir du 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.

## Voir aussi

[Dépannage de la connexion et des sandbox](/fr-CA/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes)


## Related topics

- [Prise en main d'Unreal Engine pour le développement PC](/fr-CA/build/gdk-and-engines/unreal/unreal.md)
- [Prise en main de Unity pour le développement PC (contenu)](/fr-CA/build/gdk-and-engines/unity/unity.md)
- [Prise en main du développement GameMaker pour PC](/fr-CA/build/gdk-and-engines/gamemaker.md)
- [Intégration d'un moteur personnalisé pour PC : prise en main (C/C++)](/fr-CA/build/gdk-and-engines/custom-engine.md)
- [Prise en main de Godot pour le développement XBOX](/fr-CA/build/gdk-and-engines/godot.md)