Initialisation du GDK

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 aussi, de façon facultative, appeler SteamAPI_RestartAppIfNecessary pour relancer l’application par l’intermédiaire de Steam au besoin. L’initialisation du XBOX Game Development Kit (GDK) 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 XBOX Game Development Kit (GDK), vous devez suivre les étapes suivantes.

Ajoutez un fichier MicrosoftGame.config à votre projet.
Initialisez le service Gaming Runtime.
Initialisez l’API XBOX Services pour effectuer des appels à XBOX Live concernant l’identité de l’utilisateur, les sauvegardes infonuagiques, les succès, et plus encore.
Connectez l’utilisateur à XBOX Live. Stockez le handle et l’ID 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 de compte de l’utilisateur lorsque des jeux sont lancés à partir de son service. Les API XBOX Live sont utilisées par des jeux dans plusieurs lanceurs, vous n’obtenez donc pas cela 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 de l’information sur la façon d’effectuer les étapes 2 à 4 dans Bien démarrer avec les API XBOX Live (ou en résumé ci-dessous), en veillant à implémenter également 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 créé automatiquement si vous le laissez vide.

#include <XGameRuntimeInit.h>
#include <XTaskQueue.h>
#include <xsapi-c/services_c.h>

// ...

void InitializeXboxLive()
{
    // ...
    HRESULT hr = XGameRuntimeInitialize();
    if (FAILED(hr))
    {
        // handle error: couldn't initialize the Gaming Runtime service.
    }

    XblInitArgs xblArgs = {};
    xblArgs.scid = "00000000-0000-0000-0000-000000000000"; // Add your SCID here that you got from the Partner Center web portal.

    HRESULT hr = XblInitialize(&xblArgs);
    if (FAILED(hr))
    {
        // handle error: couldn't initialize XBOX Live.
    }
    // ...
}

Connecter l’utilisateur à XBOX Live

Utilisez l’API XUserAddAsync pour connecter un utilisateur à XBOX Live. S’il s’agit de sa première connexion à votre jeu, une liste des privilèges demandés par votre jeu lui est présentée. Il devra autoriser explicitement ces privilèges pour que le jeu puisse 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 de l’information sur cet utilisateur XBOX Live, comme son gamertag, sa photo de joueur, son état de connexion, son groupe 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 à répondre à une invite d’interface utilisateur (comme une nouvelle entente de confidentialité) depuis son dernier lancement du jeu. Cependant, vous devrez tout de même effectuer ces appels d’API pour obtenir l’accès à l’identité. Un XblContextHandle sera nécessaire pour appeler les API XBOX Live. Vous pouvez utiliser la fonction XblContextCreateHandle pour obtenir un XblContextHandle à l’aide d’un XUserHandle.

GDK and Game Engines Integration

Steam porting guide

Game Principles

Core Features

Console Features

Connecter l’utilisateur à XBOX Live

​Connecter l’utilisateur à XBOX Live

Connecter l’utilisateur à XBOX Live