Passer au contenu principal
Pour commencer à utiliser Steamworks après l’avoir ajouté au projet de votre jeu, vous devez appeler la fonction SteamAPI_Init pour initialiser l’API. Vous pouvez éventuellement appeler SteamAPI_RestartAppIfNecessary pour relancer l’application via Steam si nécessaire. L’initialisation du Microsoft Game Development Kit (GDK) XBOX est un peu plus complexe, car il n’existe pas d’application unifiée servant à lancer le jeu et à communiquer avec les différents services de jeu, comme c’est le cas sur Steam. Pour commencer à utiliser les API du Microsoft Game Development Kit (GDK) XBOX, vous devez suivre les étapes ci-dessous.
  1. Ajoutez un fichier MicrosoftGame.config à votre projet.
  2. Initialisez le service Gaming Runtime.
  3. Initialisez l’API XBOX Services pour effectuer des appels à XBOX Live concernant l’identité de l’utilisateur, les sauvegardes dans le cloud, les succès, etc.
  4. Connectez l’utilisateur à XBOX Live. Stockez le handle et l’ID d’utilisateur XBOX (XUID) renvoyés après une connexion réussie pour une utilisation ultérieure.
Sur Steam, vous avez accès au Steam ID de l’utilisateur et à toutes les API dès le chargement, car le lanceur Steam injecte automatiquement les informations du compte de l’utilisateur lorsque des jeux sont lancés depuis son service. Les API XBOX Live sont utilisées par des jeux sur plusieurs lanceurs : vous ne bénéficiez donc pas de ce comportement automatiquement. Vous devez connecter manuellement l’utilisateur au lancement.
Pour savoir comment effectuer l’étape 1, consultez Vue d’ensemble de MicrosoftGame.config. Vous trouverez des informations sur la façon d’effectuer les étapes 2 à 4 dans Prise en main des API XBOX Live (ou résumées ci-dessous), en veillant également à implémenter le comportement décrit dans la section Nettoyage de XSAPI de cette rubrique. Une fois le Gaming Runtime et l’API XBOX Services initialisés, vous pouvez connecter l’utilisateur à XBOX Live. Vous n’avez pas besoin de créer un XTaskQueue, car celui-ci est automatiquement créé pour vous si vous laissez ce paramètre vide.

Connecter l’utilisateur à XBOX Live

Utilisez l’API XUserAddAsync pour connecter un utilisateur à XBOX Live. S’il se connecte à votre jeu pour la première fois, une liste des privilèges demandés par votre jeu lui est présentée. Il devra autoriser explicitement ces privilèges pour accéder à son compte XBOX Live. Une fois l’utilisateur connecté, vous pouvez utiliser la référence XUserHandle que vous avez transmise à la fonction XUserAddResult. Elle permet d’obtenir des informations sur cet utilisateur XBOX Live, telles que son gamertag, son image de joueur, son état de connexion, sa tranche d’âge et ses privilèges. Après sa première connexion, l’utilisateur devrait pouvoir se connecter silencieusement (c’est-à-dire sans aucune action de sa part) s’il n’a pas besoin de répondre à une invite de l’interface utilisateur (comme un nouvel accord de confidentialité) depuis le dernier lancement du jeu. Vous devrez toutefois effectuer ces appels d’API pour obtenir l’accès à l’identité. Un XblContextHandle est nécessaire pour appeler les API XBOX Live. Vous pouvez utiliser la fonction XblContextCreateHandle pour obtenir un XblContextHandle à partir d’un XUserHandle.
Dernière modification le 6 octobre 2026