Passer au contenu principal
Cet article explique comment préparer votre jeu GameMaker pour sa publication sur le Microsoft Store.

​
Installer les logiciels requis

Pour utiliser GameMaker Studio 2 avec le Microsoft Game Development Kit (GDK), téléchargez les logiciels suivants :
  • Visual Studio 2022
  • GDK de juin 2024 ou version ultérieure
  • CMake
    • Assurez-vous que le programme d’installation de CMake met à jour les chemins système. Sinon, le projet d’extension ne peut pas trouver CMake.

​
Mettre à jour Gaming Runtime Services (GRTS) et PC Bootstrapper

PC Bootstrapper fait partie de l’expérience de lancement des jeux sur PC et a été introduit dans la version de mai 2022 de GRTS. PC Bootstrapper dépend de GRTS pour fonctionner correctement. Si GRTS n’est pas à jour sur votre PC de développement, les tentatives de connexion peuvent échouer et renvoyer une erreur E_FAIL. Pour obtenir des conseils détaillés sur PC Bootstrapper, notamment sur son rôle dans le processus de lancement du jeu et sur son interaction avec GRTS, consultez Vue d’ensemble de PC Bootstrapper.

​
Télécharger et installer GameMaker Studio 2

Si GameMaker Studio 2 n’est pas installé, téléchargez-le depuis https://www.yoyogames.com, puis installez-le.

​
Configurer l’extension GDK de GameMaker Studio 2

L’extension GDK de GameMaker Studio 2 est nécessaire pour utiliser le GDK avec GameMaker Studio 2. Pour obtenir le code source de l’extension et les instructions de configuration, consultez https://github.com/YoYoGames/GMEXT-GDK. Suivez les étapes du fichier README situé à la racine du dépôt. Ces étapes vous permettent de configurer et de générer l’extension GDK de GameMaker Studio 2, ce qui permet d’intégrer les services et fonctionnalités XBOX dans les projets GameMaker. Lorsque vous clonez le dépôt GDKExtension, utilisez le commutateur --recurse-submodules pour inclure les sous-modules. Sinon, des fichiers requis seront manquants lors de la génération de la solution. Pour plus d’informations sur l’extension, consultez https://github.com/YoYoGames/GMEXT-GDK/wiki.

​
Générer l’extension GDK

Générez l’extension dans Visual Studio 2022 en suivant les instructions du fichier README situé à la racine du dépôt. Le fichier GDKExtension.sln est requis (<project_root>/source/GDKExtension_gml/extensions/GDKExtension/gdkextension_windows/GDKExtension.sln). Pour obtenir des instructions de génération détaillées, consultez les étapes de génération dans le fichier README situé à la racine du dépôt.

​
Créer un produit dans Microsoft Partner Center

Pour créer votre produit compatible avec les services XBOX dans Partner Center, consultez Configuration d’une application ou d’un jeu dans Partner Center, pour les partenaires gérés. Après avoir créé votre produit, vous pouvez soit tester les services XBOX, soit publier un jeu sur le Microsoft Store.

​
Tester l’extension GDK

Le dépôt de l’extension GDK inclut un exemple de projet qui montre comment intégrer le plug-in GDK à un projet GameMaker Studio 2. Le fichier de l’exemple de projet se trouve dans source/GDKExtension_gml/GDKExtension.yyp. Lorsque vous générez l’exemple de projet dans GameMaker (Build>Create Executable), sélectionnez Package as Zip pour générer le package MSIXVC nécessaire à l’installation de l’application. Si vous sélectionnez Package as Installer, la build ne produit pas de package MSIXVC. L’application ne peut alors pas accéder aux services XBOX. Une fois la build terminée, une fenêtre de l’Explorateur de fichiers s’ouvre et affiche le fichier .zip créé ainsi que son sous-répertoire. Le sous-répertoire porte le même nom que le package et contient le fichier MSIXVC. En outre, la fenêtre de sortie de GameMaker Studio 2 affiche une ligne de code contenant le chemin de sortie complet du package MSIXVC, comme dans l’exemple suivant. C:\Users\your-user-name\XboxDeveloperExperienceTe.GamePassSampleGame_1.0.0.0_x64__pmsd8ndztetqc-pkg Pour exécuter l’exemple de projet de sorte qu’il ait accès aux services XBOX, installez le package à l’aide de wdapp install avec le nom de votre package, comme dans l’exemple suivant. wdapp install XboxDeveloperExperienceTe.GamePassSampleGame_1.0.0.0_x64__pmsd8ndztetqc.msixvc Une fois le package installé, lancez-le à l’aide du bouton Démarrer.

​
Mettre à jour MicrosoftGame.config

L’exemple de projet utilise un fichier MicrosoftGame.config par défaut. Pour tester l’exemple ou votre propre projet GameMaker Studio 2 avec les informations de configuration Partner Center de votre projet, mettez à jour le fichier MicrosoftGame.config. Le fichier .config de l’exemple se trouve dans source/GDKExtension_gml/datafiles/MicrosoftGame.config. Pour utiliser les fonctionnalités des services XBOX, mettez à jour le fichier MicrosoftGame.config de votre projet avec les détails d’identité de votre projet Partner Center en procédant comme suit.
  1. Accédez au tableau de bord Partner Center.
  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. Copiez ces valeurs depuis Partner Center dans l’élément et le champ correspondants de MicrosoftGame.config.
Les détails d’identité de Partner Center déterminent le contenu de votre fichier MicrosoftGame.config, comme dans l’exemple suivant.

​
Exemple d’extrait de fichier MicrosoftGame.config

Pour une vue d’ensemble de MicrosoftGame.config et des informations sur ses valeurs, consultez Vue d’ensemble de MicrosoftGame.config.

​
Intégrer l’extension GDK dans votre projet

Au minimum, votre projet doit appeler les fonctions suivantes pour s’intégrer au GDK.
  • Appelez gdk_init pour initialiser le GDK. Vous devez appeler gdk_init avant d’utiliser toute autre fonctionnalité du GDK.
  • Appelez gdk_update une fois par image tant que le GDK est actif.
  • Appelez gdk_quit pour nettoyer le GDK lorsque votre projet se termine et que vous n’avez plus besoin d’aucune fonctionnalité du GDK.
En outre, l’extension GDK comprend les modules suivants qui donnent accès aux fonctionnalités du GDK.
  • Module de base : fournit un ensemble de fonctions qui contrôlent la sélection de l’utilisateur/du compte pour le joueur
  • Module de stockage : fournit un ensemble de fonctions qui contrôlent le chargement et l’enregistrement des données associées à un utilisateur.
  • Module des services XBOX : fournit des fonctions permettant d’utiliser des fonctionnalités des services XBOX, notamment les statistiques, les classements, les succès et la présence enrichie.
  • Module des achats in-app : fournit des fonctions qui intègrent les projets GameMaker aux systèmes de commerce du Microsoft Store via le GDK.
Le guide inclus dans le dépôt GDKExtension documente les fonctions GDK dans la section GDK Extension APIs. Le guide, au format .pdf, se trouve dans source/GDKExtension_gml/datafiles/GDK_Extension_Documentation.pdf.

​
Tester les services XBOX dans votre jeu

Pour tester les fonctionnalités des services XBOX (par exemple, les succès) dans votre jeu, utilisez une sandbox et des comptes de test ayant accès à cette sandbox.

​
Créer un compte de test

Pour tester les fonctionnalités des services XBOX dans votre jeu, créez des comptes de test ayant accès à votre sandbox de développement. Pour obtenir des instructions, consultez Création de comptes de test.

​
Changer de sandbox

  1. Accédez à Partner Center.
  2. Pour trouver votre ID de sandbox, sélectionnez XBOX services, puis sélectionnez Gameplay settings.
    Votre ID de sandbox apparaît sur le premier onglet de la page Gameplay settings. Il se présente sous la forme « ABCDEF.0 ».
  3. Sélectionnez le bouton Démarrer.
  4. Entrez Microsoft GDK Command Prompts, puis sélectionnez Entrée.
  5. Ouvrez la première invite de commandes, puis entrez XblPCSandbox.exe <your sandbox ID>.
  6. Une fois que l’invite de commandes a lancé plusieurs applications, connectez-vous à l’application XBOX à l’aide de votre compte de test.
Si vous parvenez à vous connecter, vous pouvez commencer les tests dans votre sandbox. Pour plus d’informations sur les sandbox, consultez Vue d’ensemble des sandbox des services XBOX.

​
Publier votre jeu

Pour vous préparer à publier votre jeu, assurez-vous de :
  • Créer un package MSIXVC à l’aide de Package as Zip dans GameMaker Studio 2.
  • Mettre à jour votre fichier MicrosoftGame.config avec les valeurs correctes du projet que vous avez créé dans Partner Center.
  • Intégrer l’extension GDK dans votre jeu.
Une fois les étapes de cet article terminées, vous êtes prêt à publier votre jeu. Pour le soumettre, accédez à Partner Center et suivez les instructions de l’interface utilisateur.
Dernière modification le 6 octobre 2026