Passer au contenu principal
Cet article décrit 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 les 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 des GRTS. PC Bootstrapper dépend des GRTS pour fonctionner correctement. Si les GRTS ne sont pas à jour sur votre PC de développement, les tentatives de connexion peuvent échouer et retourner une erreur E_FAIL. Pour obtenir des conseils détaillés sur PC Bootstrapper, notamment son rôle dans le processus de lancement des jeux et son interaction avec les 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 à partir de https://www.yoyogames.com, puis installez-le.

​
Configurer l’extension GDK de GameMaker Studio 2

L’extension GDK de GameMaker Studio 2 est requise pour utiliser le GDK avec GameMaker Studio 2. Pour le code source de l’extension et les instructions de configuration, consultez https://github.com/YoYoGames/GMEXT-GDK. Suivez les étapes du fichier README à 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 XBOX services et leurs fonctionnalités 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 lorsque vous générerez 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 à la racine du dépôt. Le fichier GDKExtension.sln est requis (<project_root>/source/GDKExtension_gml/extensions/GDKExtension/gdkextension_windows/GDKExtension.sln). Pour des instructions de génération détaillées, consultez les étapes de génération dans le fichier README à la racine du dépôt.

​
Créer un produit dans Microsoft Partner Center

Pour créer votre produit compatible avec les XBOX services 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 tester les XBOX services ou publier un jeu sur le Microsoft Store.

​
Tester l’extension GDK

Le dépôt de l’extension GDK comprend 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 à l’emplacement 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 génération ne produit pas de package MSIXVC. L’application ne peut alors pas accéder aux XBOX services. À la fin de la génération, une fenêtre de l’Explorateur de fichiers s’ouvre et affiche le fichier .zip créé et son sous-répertoire. Le sous-répertoire porte le même nom que le package et contient le fichier MSIXVC. De plus, la fenêtre de sortie de GameMaker Studio 2 affiche une ligne de code avec 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 façon à ce qu’il ait accès aux XBOX services, 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 de votre projet dans Partner Center, 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 XBOX services, mettez à jour le fichier MicrosoftGame.config de votre projet avec les détails d’identité de votre projet dans Partner Center en suivant les étapes ci-dessous.
  1. Accédez au tableau de bord de 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 de 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 trame 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.
De plus, 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 ou 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 XBOX services : Fournit des fonctions permettant d’utiliser des fonctionnalités des XBOX services, notamment les statistiques, les classements, les succès et la présence enrichie.
  • Module Achats intégrés : Fournit des fonctions qui intègrent les projets GameMaker aux systèmes commerciaux du Microsoft Store par l’intermédiaire du GDK.
Le guide inclus dans le dépôt GDKExtension documente les fonctions du GDK dans la section GDK Extension APIs. Ce guide, au format .pdf, se trouve dans source/GDKExtension_gml/datafiles/GDK_Extension_Documentation.pdf.

​
Tester les XBOX services dans votre jeu

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

​
Créer 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 obtenir des instructions, consultez Création de comptes de test.

​
Changer de bac à sable

  1. Accédez à Partner Center.
  2. Pour trouver l’ID de votre bac à sable, sélectionnez XBOX services, puis Gameplay settings.
    L’ID de votre bac à sable apparaît dans le premier onglet de la page Gameplay settings. Il porte un nom comme « 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 bac à sable. Pour plus d’informations sur les bacs à sable, consultez Vue d’ensemble des bacs à sable des XBOX services.

​
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