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 surXTaskQueue 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.
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 deHttpClient.
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 objetXboxLiveContext 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 objetXboxLiveContext 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’appelerXblCleanupAsync() 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.