> ## 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 moteur C/C++ personnalisé > Intégrez le GDK, les Gaming Runtime Services (GRTS) et XSAPI dans un moteur C/C++ sans prise en charge intégrée du GDK pour publier sur le Microsoft Store sur PC et XBOX. Utilisez cette rubrique si vous préparez votre jeu pour la publication sur le Microsoft Store sur PC et que votre jeu utilise un moteur basé sur C/C++ qui n'offre pas de prise en charge intégrée du GDK. * [Création d'un produit dans Partner Center](#creating-a-product-in-partner-center) * [Intégration du GDK dans les jeux C/C++](#integrating-the-gdk-into-c-c-games) * [Test des XBOX services dans votre jeu](#testing-xbox-services-in-your-game) * [Publication](#publishing) ## Création d'un produit dans Partner Center Avant de pouvoir publier un jeu sur le Microsoft Store, vous devez créer votre produit compatible avec les 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](/fr-CA/services/xbox-services/fundamentals/portal-config/live-setup-partner-center-partners). ## Intégration du GDK dans les jeux C/C++ Pour intégrer le GDK dans un jeu C/C++, le jeu a besoin de 4 éléments : 1. Les *fichiers d'en-tête* du GDK et de l'API XBOX Services (XSAPI) qui décrivent les signatures d'API et les structures de données. 2. Les *bibliothèques d'importation* qui indiquent à l'éditeur de liens comment résoudre les références externes aux fonctions exportées du GDK. 3. Les bibliothèques statiques XSAPI ou les *bibliothèques d'importation* qui indiquent à l'éditeur de liens comment résoudre les références externes aux fonctions exportées des DLL XSAPI. * XSAPI est offert sous forme statique et dynamique. Consultez le tableau ci-dessous pour plus d'informations et choisissez la forme statique ou dynamique. 4. Les *bibliothèques de liens dynamiques* qui contiennent l'implémentation d'exécution réelle des fonctions du GDK et de XSAPI (si vous utilisez la version dynamique de XSAPI). Pour que les jeux s'intègrent aux expériences essentielles de l'écosystème XBOX, ils doivent interagir avec deux composants : les Gaming Runtime Services (GRTS) et XSAPI. Voici les fichiers nécessaires à un jeu non managé : | Composant | GRTS (dynamique uniquement) | XSAPI (dynamique) | XSAPI (statique) | | - | - | - | - | | En-têtes | En-têtes GRTS : XUser, XGameSave, XGameUI, etc. (du GDK) | En-têtes XSAPI : profile\_c.h, achievements\_c.h, etc. (du GDK) | En-têtes XSAPI : profile\_c.h, achievements\_c.h, etc. (du GDK) | | Bibliothèque d'importation | xgameruntime.lib (du GDK) | Microsoft.Xbox.Services.GDK.C.Thunks.lib (du GDK) | Microsoft.Xbox.Services.142.GDK.C.lib (du GDK) | | Bibliothèque de liens dynamiques | xgameruntime.dll et quelques autres DLL (installées dans system32 par GRTS) | Microsoft.Xbox.Services.GDK.C.Thunks.dll (du GDK, doit être inclus dans le package du jeu) | Non requis | Pour les jeux qui utilisent une architecture basée sur des plug-ins, avec des fonctionnalités réparties sur plusieurs DLL, nous recommandons et prenons en charge l'intégration de XSAPI à l'aide de `Thunks.dll`. Cette approche fonctionne de façon fiable sur les plateformes PC et XBOX. Lorsque vous liez XSAPI de manière statique dans plusieurs DLL, chaque DLL conserve sa propre copie de l'état global. Par conséquent, l'appel de `XblInitialize` dans une DLL n'initialise pas XSAPI dans les autres. Le partage de handles XSAPI entre des DLL ayant des instances statiques distinctes peut entraîner des plantages ou un comportement imprévisible. `Thunks.dll` résout ce problème en fournissant une instance partagée unique de XSAPI et de son état. Cela évite la duplication et garantit un comportement cohérent dans toutes les DLL. Bien qu'il soit techniquement possible de lier XSAPI de manière statique dans une seule DLL et d'en exporter les symboles, cette approche est plus complexe et sujette aux erreurs. L'utilisation de `Thunks.dll` est plus simple, plus sûre et entièrement prise en charge. ### Ajout des exigences des Gaming Runtime Services et de XSAPI à votre projet Les étapes suivantes décrivent les modifications à apporter à votre projet pour qu'il réponde à toutes les exigences d'utilisation des Gaming Runtime Services et de XSAPI. 1. Assurez-vous que la cible est x64. Dans Visual Studio, accédez à **Build**->**Configuration Manager** et définissez **Active solution platform** sur x64. 2. Ajoutez les chemins d'inclusion suivants : `C:\Program Files (x86)\Microsoft GDK\[GDK version number]\GRDK\GameKit\Include` `C:\Program Files (x86)\Microsoft GDK\[GDK version number]\GRDK\ExtensionLibraries\Xbox.Services.API.C\Include` `C:\Program Files (x86)\Microsoft GDK\[GDK version number]\GRDK\ExtensionLibraries\Xbox.LibHttpClient\Include` Où **GDK version number** correspond à un répertoire nommé selon l'année, le mois et le numéro de sous-version de la version. Par exemple, pour le GDK de juin 2022, le nom du répertoire serait 220600. Pour Microsoft GDK (juin 2024) ou une version antérieure, utilisez *C:\Program Files (x86)\Microsoft GDK\\\[GDK version number]\GRDK\ExtensionLibraries\Xbox.Services.API.C\DesignTime\CommonConfiguration\Neutral\Include* et *C:\Program Files (x86)\Microsoft GDK\\\[GDK version number]\GRDK\ExtensionLibraries\Xbox.LibHttpClient\DesignTime\CommonConfiguration\Neutral\Include* Dans Visual Studio, ajoutez ces chemins dans la page des propriétés du projet sous **Configuration Properties**->**VC++ Directories**->**Include Directories**. 3. Ajoutez les chemins de bibliothèque suivants pour les bibliothèques d'importation : `C:\Program Files (x86)\Microsoft GDK\[GDK version number]\GRDK\GameKit\Lib\amd64` `C:\Program Files (x86)\Microsoft GDK\[GDK version number]\GRDK\ExtensionLibraries\Xbox.Services.API.C\Lib\x64\Release` `C:\Program Files (x86)\Microsoft GDK\[GDK version number]\GRDK\ExtensionLibraries\Xbox.LibHttpClient\Lib\x64` Où **GDK version number** correspond à un répertoire nommé selon l'année, le mois et le numéro de sous-version de la version. Par exemple, pour le GDK de juin 2022, le nom du répertoire serait 220600. Pour Microsoft GDK (juin 2024) ou une version antérieure, utilisez *C:\Program Files (x86)\Microsoft GDK\\\[GDK version number]\GRDK\ExtensionLibraries\Xbox.Services.API.C\DesignTime\CommonConfiguration\Neutral\Lib\Release* et *C:\Program Files (x86)\Microsoft GDK\\\[GDK version number]\GRDK\ExtensionLibraries\Xbox.LibHttpClient\DesignTime\CommonConfiguration\Neutral\Lib* Dans Visual Studio, ajoutez ces chemins dans la page des propriétés du projet sous **Configuration Properties**->**VC++ Directories**->**Library Directories**. 4. Ajoutez les bibliothèques suivantes à la liste des bibliothèques liées à votre projet : `C:\Program Files (x86)\Microsoft GDK\[GDK version number]\GRDK\GameKit\Lib\amd64\xgameruntime.lib` `C:\Program Files (x86)\Microsoft GDK\[GDK version number]\GRDK\ExtensionLibraries\Xbox.Services.API.C\Lib\x64\Release\Microsoft.Xbox.Services.GDK.C.Thunks.lib (or Microsoft.Xbox.Services.142.GDK.C.lib, if statically linking)` `C:\Program Files (x86)\Microsoft GDK\[GDK version number]\GRDK\ExtensionLibraries\Xbox.LibHttpClient\Lib\x64\libHttpClient.GDK.lib` Où **GDK version number** correspond à un répertoire nommé selon l'année, le mois et le numéro de sous-version de la version. Par exemple, pour le GDK de juin 2022, le nom du répertoire serait 220600. Pour Microsoft GDK (juin 2024) ou une version antérieure, utilisez *C:\Program Files (x86)\Microsoft GDK\\\[GDK version number]\GRDK\ExtensionLibraries\Xbox.Services.API.C\DesignTime\CommonConfiguration\Neutral\Lib\Release\Microsoft.Xbox.Services.GDK.C.Thunks.lib (ou Microsoft.Xbox.Services.142.GDK.C.lib, en cas de liaison statique)* et *C:\Program Files (x86)\Microsoft GDK\\\[GDK version number]\GRDK\ExtensionLibraries\Xbox.LibHttpClient\DesignTime\CommonConfiguration\Neutral\Lib\libHttpClient.GDK.lib* Dans Visual Studio, ajoutez les bibliothèques dans la page des propriétés du projet sous **Configuration Properties**->**Linker**->**Input**->**Additional Dependencies**. 5. Définissez *\_GAMING\_DESKTOP* et *WINAPI\_FAMILY=WINAPI\_FAMILY\_DESKTOP\_APP*. Dans Visual Studio, ajoutez la ligne suivante dans la page des propriétés du projet sous **C/C++**->**Command Line**->**Additional Options** : `/D "_GAMING_DESKTOP" /D "WINAPI_FAMILY=WINAPI_FAMILY_DESKTOP_APP"` 6. Créez un fichier MicrosoftGame.config et assurez-vous qu'il est copié dans la même destination que le fichier .exe lors des builds. **Remarque :** Si votre moteur prend en charge une fonctionnalité d'exécution dans l'éditeur qui utilise un autre fichier .exe lors de l'exécution, copiez également MicrosoftGame.config dans le même répertoire que ce fichier .exe. Si MicrosoftGame.config n'est pas présent dans le même répertoire que le fichier .exe, les XBOX services ne fonctionneront pas lorsque vous utilisez votre fonctionnalité d'exécution dans l'éditeur. Pour commencer le développement, vous pouvez utiliser une configuration avec des valeurs par défaut comme dans l'exemple suivant. Les valeurs Identity Name, Executable Name et Executable Alias seraient toutes remplacées par le nom de votre exécutable. ```xml theme={null} ``` 7. Assurez-vous que des copies de **Microsoft.Xbox.Services.GDK.C.Thunks.dll** (en cas de liaison dynamique), **XCurl.dll** et **libHttpClient.GDK.dll** sont copiées dans la même destination que le fichier .exe lors des builds. **Remarque :** Si votre moteur prend en charge une fonctionnalité d'exécution dans l'éditeur qui utilise un autre fichier .exe lors de l'exécution, assurez-vous que ce fichier .exe référence également ces DLL. Si les DLL ne sont pas référencées par le fichier .exe, les XBOX services ne fonctionneront pas lorsque vous utilisez votre fonctionnalité d'exécution dans l'éditeur. En cas de liaison dynamique à XSAPI, **Microsoft.Xbox.Services.GDK.C.Thunks.dll** se trouve dans l'installation du GDK, dans le répertoire suivant : `C:\Program Files (x86)\Microsoft GDK\[GDK version number]\GRDK\ExtensionLibraries\Xbox.Services.API.C\Lib\x64\[Debug|Release]` **XCurl.dll** se trouve dans l'installation du GDK, dans le répertoire suivant : `C:\Program Files (x86)\Microsoft GDK\[GDK version number]\GRDK\ExtensionLibraries\Xbox.XCurl.API\Redist\x64` **libHttpClient.GDK.dll** se trouve dans l'installation du GDK, dans le répertoire suivant : `C:\Program Files (x86)\Microsoft GDK\[GDK version number]\GRDK\ExtensionLibraries\Xbox.LibHttpClient\Redist\x64` Où **GDK version number** correspond à un répertoire nommé selon l'année, le mois et le numéro de sous-version de la version. Par exemple, pour le GDK de juin 2022, le nom du répertoire serait 220600. Pour Microsoft GDK (juin 2024) ou une version antérieure, utilisez *C:\Program Files (x86)\Microsoft GDK\\\[GDK version number]\GRDK\ExtensionLibraries\Xbox.Services.API.C\DesignTime\CommonConfiguration\Neutral\Lib\\\[Debug|Release]*, *C:\Program Files (x86)\Microsoft GDK\\\[GDK version number]\GRDK\ExtensionLibraries\Xbox.XCurl.API\Redist\CommonConfiguration\neutral* et *C:\Program Files (x86)\Microsoft GDK\\\[GDK version number]\GRDK\ExtensionLibraries\Xbox.LibHttpClient\Redist\CommonConfiguration\neutral* Si vous intégrez le GDK dans un projet Visual Studio Desktop existant, vous pouvez également suivre les étapes de cette rubrique pour convertir votre projet en projet GDK : [Ajout du Microsoft Game Development Kit à un projet de bureau existant](https://learn.microsoft.com/gaming/gdk/_content/gc/gdk-dev/pc-dev/overviews/gr-add-to-existing-project). ### Mise à jour de MicrosoftGame.config Le fichier MicrosoftGame.config créé à l'étape précédente contient des valeurs par défaut qui permettent un développement initial sur PC et XBOX sans configuration supplémentaire. Vous devez mettre à jour ces valeurs uniquement lorsque vous commencez à utiliser des fonctionnalités du Gaming Runtime, du Microsoft Store et de l'identité du titre. Pour utiliser les fonctionnalités des XBOX services, mettez à jour le fichier MicrosoftGame.config de votre projet avec les détails d'identité de votre projet dans Partner Center. 1. Accédez au [tableau de bord de Partner Center](https://partner.microsoft.com/dashboard/windows/overview). 2. Sélectionnez votre jeu dans la liste des produits. 3. Sélectionnez l'onglet **Game setup**, puis sélectionnez **Identity details**. 4. Sélectionnez **Show Details** pour développer la section **Identity details**. 5. Utilisez les valeurs suivantes du tableau de la section **Identity details**, puis copiez ces valeurs de Partner Center dans l'élément et le champ correspondants de MicrosoftGame.config. | Nom dans Partner Center | MicrosoftGame.config | | - | - | | XBOX Title ID | TitleId | | Package/Identity/Name | Identity->Name | | Package/Identity/Publisher | Identity->Publisher | | XBOX services -> XBOX Settings -> MSAAppId | MSAAppId | Par exemple, les détails d'identité suivants dans Partner Center donneraient un fichier MicrosoftGame.config semblable à l'exemple ci-dessous : | Nom dans Partner Center | Exemple de valeur | | - | - | | XBOX Title ID | 64353034 | | Package/Identity/Name | 41336MicrosoftATG.Achievements2017Redux | | Package/Identity/Publisher | CN=A4954634-DF4B-47C7-AB70-D3215D246AF1 | | XBOX services -> XBOX Settings -> MSAAppId | 0000000000000000 | ```xml theme={null} 64353034 0000000000000000 ``` Consultez [Vue d'ensemble de MicrosoftGame.config](/fr-CA/build/core-features/common/game-config/MicrosoftGameConfig-Overview) pour plus d'informations sur les valeurs de MicrosoftGame.config. ### Initialiser le runtime de jeu et XSAPI Les étapes suivantes montrent comment initialiser les Gaming Runtime Services et XSAPI dans votre jeu. 1. Incluez l'en-tête XGameRuntime et l'en-tête services-c de XSAPI. ```cpp theme={null} #include #include ``` 2. Appelez [XGameRuntimeInitialize](/fr-CA/reference/system/xgameruntimeinit/functions/xgameruntimeinitialize) pour initialiser le runtime du GDK. ```cpp theme={null} // Initialize the GameRuntime HRESULT hr = XGameRuntimeInitialize(); if (FAILED(hr)) { if (hr == E_GAMERUNTIME_DLL_NOT_FOUND || hr == E_GAMERUNTIME_VERSION_MISMATCH) { (void)MessageBoxW(nullptr, L"Game Runtime is not installed on this system or needs updating.", g_szAppName, MB_ICONERROR | MB_OK); } return 1; } ``` 3. Appelez [XblInitialize](/fr-CA/reference/live/xsapi-c/xbox_live_global_c/functions/xblinitialize) pour initialiser XSAPI. ```cpp theme={null} XblInitArgs xblArgs = {}; //xblArgs.queue = queue; // Uncomment this line if you've chosen to create your own XTaskQueue. Otherwise, by default, this line is not needed. xblArgs.scid = "00000000-0000-0000-0000-000000000000"; // Add your scid from your Partner Center project here; HRESULT hr = XblInitialize(&xblArgs); if (FAILED(hr)) { // Handle failure } ``` ### Désinitialisation du runtime de jeu Les Gaming Runtime Services doivent être désinitialisés avant la fermeture de votre jeu. XSAPI n'a pas besoin d'être nettoyé explicitement avant la fermeture. Désinitialisez le runtime du GDK en appelant [XGameRuntimeUninitialize](/fr-CA/reference/system/xgameruntimeinit/functions/xgameruntimeuninitialize). ```cpp theme={null} // Uninitialize the Gaming Runtime after // all other activity has been completed. XGameRuntimeUninitialize(); ``` Consultez [Bien démarrer avec les API des XBOX services](/fr-CA/services/xbox-services/fundamentals/xbox-services-api/live-gs-xbl-apis) pour une vue d'ensemble détaillée de l'utilisation de XSAPI dans votre jeu.
Consultez [Fonctionnalités du Game Development Kit (GDK)](https://learn.microsoft.com/gaming/gdk/_content/gc/features/features-index) pour des vues d'ensemble de l'implémentation des fonctionnalités du GDK. ## Test des XBOX services dans votre jeu Pour tester les fonctionnalités des XBOX services dans votre jeu, comme les succès, vous devez utiliser un bac à sable et des comptes de test ayant accès à ce bac à sable. ### Création d'un compte de test Pour tester les fonctionnalités des XBOX services dans votre jeu, créez des comptes de test ayant accès à votre bac à sable de développement. Pour plus d'informations sur la création de comptes de test, consultez [Création de comptes de test](/fr-CA/services/xbox-services/develop/test-accounts/live-setup-testaccounts). ### Changement de bac à sable Après avoir créé un compte de test, utilisez-le pour accéder à votre bac à sable en suivant les étapes ci-dessous. 1. Pour trouver l'ID de votre bac à sable, accédez à [Partner Center](https://partner.microsoft.com/dashboard/windows/overview). 2. Sélectionnez **XBOX services**, puis sélectionnez **Gameplay Settings**. L'ID de votre bac à sable se trouve dans le premier onglet et porte un nom comme « ABCDEF.0 ». 3. Ouvrez le menu **Démarrer**. 4. Entrez **Microsoft GDK Command Prompts**, puis appuyez sur **Entrée** sur votre clavier. 5. Ouvrez la première invite de commandes. 6. Dans l'invite de commandes, entrez **XblPCSandbox.exe \[your sandbox ID]**. 7. Une fois que l'invite de commandes a lancé plusieurs applications, connectez-vous à l'application XBOX avec votre compte de test. Si vous parvenez à vous connecter, vous avez créé un compte de test et changé de bac à sable pour commencer les tests. Pour plus d'informations sur les bacs à sable, consultez [Vue d'ensemble des bacs à sable des XBOX services](/fr-CA/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox). ## Publication Pour être prêt à publier votre jeu, vous devez : * Avoir terminé l'intégration de votre jeu avec le GDK * Avoir créé un package de jeu en suivant les étapes de [Bien démarrer avec la création de packages de titres pour PC à l'aide des outils de création de packages MSIXVC](/fr-CA/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC) Une fois ces deux exigences remplies, vous êtes prêt à publier. Pour soumettre votre jeu, accédez à [Partner Center](https://partner.microsoft.com/dashboard/windows/overview) et suivez les instructions de l'interface utilisateur. ## Related topics - [Intégrer le GDK à un projet Unreal Engine antérieur à la version 4.26](/fr-CA/build/gdk-and-engines/unreal/unreal-legacy.md) - [Aperçu de Godot et des moteurs communautaires](/fr-CA/paths/community-engines/overview.md) - [Utiliser le GDK avec Unity, Unreal et d'autres moteurs](/fr-CA/build/gdk-and-engines/gdk-and-engines.md) - [Vue d'ensemble de bout en bout pour PC](/fr-CA/build/gdk-and-engines/overview.md) - [Développer un nouveau titre GDK](/fr-CA/home/build-first-title/developing-new-titles.md)