Passer au contenu principal

Initialiser Gaming Runtime Services

Les XSAPI dépendent de Gaming Runtime Services (GRTS). Avant d’appeler une XSAPI, initialisez GRTS comme suit.

Créer une XTaskQueue (facultatif)

La plupart des XSAPI sont des API asynchrones qui nécessitent l’utilisation d’une file d’attente de tâches. Il s’agit d’une API qui permet de mettre en file d’attente le travail et les rappels d’achèvement des tâches. Pour en savoir plus sur XTaskQueue et les différents modes de distribution, consultez Conception de la file d’attente de tâches asynchrones. Par exemple, le code suivant crée une file d’attente de tâches à l’aide d’un pool de threads système.
Veillez à restituer au système le handle de la file d’attente de tâches obtenu lorsque vous n’en avez plus besoin.
Si vous choisissez de ne pas créer votre propre file d’attente de tâches, veillez à transmettre nullptr lorsqu’un handle de file d’attente est requis. Lorsque nullptr est utilisé, le système de tâches utilise ThreadPool par défaut. Ce comportement peut être remplacé en appelant XTaskQueueSetCurrentProcessTaskQueue.

Configurer le traçage HttpClient (facultatif)

Pour afficher des informations de débogage supplémentaires à l’exécution, veillez à configurer la fonctionnalité de traçage de HttpClient. Le code suivant définit le niveau de traçage de HttpClient et active la sortie des informations du débogueur.

Initialiser XSAPI

Initialisez XSAPI avant d’appeler une XSAPI.

Connecter l’utilisateur au réseau XBOX

La plupart des XSAPI exigent que l’utilisateur se connecte d’abord au réseau XBOX. Pour connecter un utilisateur au réseau XBOX, consultez l’exemple de code de l’API XUserAddAsync.

Créer un objet XboxLiveContext

Un objet XboxLiveContext représente le contexte de service associé à un utilisateur particulier. La plupart des XSAPI vous demandent de transmettre un XboxLiveContextHandle qui représente le contexte de l’utilisateur appelant. Pour créer un contexte XBOX Live (réseau), utilisez l’API XblContextCreateHandle et transmettez l’objet XUserHandle obtenu à l’étape précédente.

Effectuer un appel de service aux services XBOX

Maintenant que vous disposez d’un objet XboxLiveContext associé à l’objet XUserHandle de l’utilisateur connecté, vous pouvez effectuer des appels de service aux services XBOX. Par exemple, pour récupérer la liste d’amis de l’utilisateur, vous pouvez procéder comme suit :

Nettoyage de XSAPI

Il n’est nécessaire d’appeler XblCleanupAsync() dans aucun scénario. Dans un scénario d’arrêt de l’application, il n’existe actuellement aucune API XblCleanup() synchrone que vous puissiez appeler. Par nature, l’arrêt d’une application doit être géré de manière synchrone et immédiate. Par conséquent, on s’appuie sur le nettoyage normal au niveau du système d’exploitation, qui a lieu lors de l’arrêt du processus de l’application, et celui-ci suffit dans cette situation. Dans un scénario où l’application est suspendue, XSAPI se charge de libérer puis de restaurer les ressources système nécessaires à son fonctionnement afin de maintenir ses fonctionnalités après la reprise. XblCleanupAsync() peut néanmoins être utilisée dans les cas où votre jeu choisit délibérément de libérer les ressources allouées à XSAPI.
Dernière modification le 20 octobre 2026