XGameStreaming

Initialisation

API nécessaires pour initialiser les fonctionnalités de streaming de jeu.

Fonction	Description
XGameStreamingInitialize	Initialise les API de streaming de jeu.
XGameStreamingUninitialize	Annule l’initialisation des API de streaming de jeu.

Propriétés du client

API permettant d’obtenir les propriétés des appareils de streaming ou de leur flux de jeu

Fonctions

Fonction	Description
XGameStreamingClientPropertiesChangedCallback	Notification indiquant que les propriétés d’un appareil de streaming ont changé.
XGameStreamingGetClientIPAddress	Déprécié. Obtient l’adresse IP du client de streaming. Utilisez plutôt les revendications du jeton XSTS.
XGameStreamingGetDisplayDetails	Obtient les détails de l’affichage du client de streaming.
XGameStreamingGetSessionId	Obtient l’ID de session du client de streaming.
XGameStreamingGetStreamPhysicalDimensions	Obtient la taille physique du flux vidéo tel qu’il est actuellement rendu sur le client de streaming.
XGameStreamingGetTouchBundleVersion	Obtient la version du bundle d’adaptation tactile actuellement utilisé sur l’appareil spécifié.
XGameStreamingGetTouchBundleVersionNameSize	Obtient la taille du nom de version spécifié dans le bundle d’adaptation tactile sur l’appareil spécifié.
XGameStreamingIsTouchInputEnabled	Vérifie si un client enverra des entrées tactiles au jeu.
XGameStreamingRegisterClientPropertiesChanged	Inscrit un rappel à appeler lorsque l’une des propriétés de l’appareil client de streaming change.
XGameStreamingUnregisterClientPropertiesChanged	Désinscrit un XGameStreamingClientPropertiesChangedCallback précédemment inscrit.

Énumérations

Énumération	Description
XGameStreamingClientProperty	Propriétés pouvant être interrogées concernant l’appareil client de streaming.
XGameStreamingVideoFlags	Fonctionnalités vidéo disponibles pouvant être prises en charge par l’appareil client de streaming.

Structures

Structures	Description
XGameStreamingDisplayDetails	Détails sur l’affichage de l’appareil client de streaming.

État de la connexion

API nécessaires pour gérer l’état de connexion des appareils clients de streaming.

Fonctions

Fonction	Description
XGameStreamingConnectionStateChangedCallback	Fonction de rappel appelée chaque fois que l’état d’un client de streaming connecté change.
XGameStreamingGetClientCount	Nombre d’appareils de streaming actuellement connectés.
XGameStreamingGetClients	Obtient les identificateurs de chaque client actuellement connecté.
XGameStreamingGetConnectionState	Obtient l’état de connexion actuel de l’appareil spécifié.
XGameStreamingIsStreaming	Détermine si le jeu est actuellement diffusé en streaming.
XGameStreamingRegisterConnectionStateChanged	Inscrit un rappel à appeler lorsque l’état de connexion d’un appareil client de streaming change.
XGameStreamingUnregisterConnectionStateChanged	Désinscrit un XGameStreamingConnectionStateChangedCallback précédemment inscrit.

Énumérations

Énumération	Description
XGameStreamingConnectionState	États de connexion d’un appareil client de streaming.

Latence

API permettant d’adapter le gameplay à la latence du streaming.

Fonctions

Fonction	Description
XGameStreamingGetStreamAddedLatency	Obtient la moyenne récente de la latence liée au streaming.
XGameStreamingGetLastFrameDisplayed	Déprécié. Obtient le jeton de pipeline de frame de la frame affichée le plus récemment sur l’écran du client de streaming.
XGameStreamingGetAssociatedFrame	Déprécié. Obtient le jeton de pipeline de frame à partir d’une lecture d’entrée spécifique.

Emplacement du serveur

API permettant d’accéder à l’emplacement à partir duquel le jeu est diffusé en streaming.

Fonctions

Fonction	Description
XGameStreamingGetServerLocationName	Obtient l’emplacement du centre de données du serveur de streaming.
XGameStreamingGetServerLocationNameSize	Obtient la taille du nom de l’emplacement du centre de données du serveur de streaming

Adaptation tactile

API permettant de gérer les dispositions de contrôleur tactile qui seront exposées aux clients de streaming appropriés.

Fonctions

Fonction	Description
XGameStreamingGetGamepadPhysicality	Obtient le mappage de physicalité des entrées à partir d’une lecture de manette spécifique.
XGameStreamingHideTouchControls	Demande à tous les appareils clients de streaming connectés de masquer la disposition tactile si elle est visible.
XGameStreamingHideTouchControlsOnClient	Demande à un appareil client de streaming spécifié de masquer la disposition tactile si elle est visible.
XGameStreamingShowTouchControlLayout	Demande à tous les appareils clients de streaming connectés d’afficher une disposition tactile spécifiée.
XGameStreamingShowTouchControlLayoutOnClient	Demande à un appareil client de streaming connecté spécifié d’afficher une disposition tactile spécifiée.
XGameStreamingShowTouchControlsWithStateUpdate	Demande à tous les appareils clients de streaming connectés de mettre à jour l’état de leurs contrôles tactiles, puis d’afficher une disposition tactile spécifiée.
XGameStreamingShowTouchControlsWithStateUpdateOnClient	Demande à un appareil client de streaming spécifié de mettre à jour l’état de ses contrôles tactiles, puis d’afficher une disposition tactile spécifiée.
XGameStreamingUpdateTouchControlsState	Met à jour l’état des contrôles tactiles sur tous les appareils clients de streaming connectés.
XGameStreamingUpdateTouchControlsStateOnClient	Met à jour l’état des contrôles tactiles sur un appareil client de streaming spécifié.

Énumérations

Énumération	Description
XGameStreamingGamepadPhysicality	Mappage de physicalité pour tous les boutons, sticks et gâchettes d’une manette sans fil XBOX standard. Pour un bouton, stick ou gâchette donné, la physicalité peut être inconnue, physique, virtuelle ou les deux.
XGameStreamingTouchControlsStateOperationKind	Opérations pouvant être effectuées lors de la mise à jour de l’état de la disposition des contrôles tactiles.
XGameStreamingTouchControlsStateValueKind	Spécifie le type de l’état associé aux dispositions tactiles.

Structures

Structures	Description
XGameStreamingTouchControlsStateOperation	Spécifie l’opération, le chemin d’accès à la variable spécifique et la valeur à appliquer.
XGameStreamingTouchControlsStateValue	Fournit le type et la valeur d’un élément spécifique de l’état des contrôles tactiles.

Résolution

API permettant de gérer la résolution du flux.

Fonctions

Fonction	Description
XGameStreamingSetResolution	Définit la résolution du flux vidéo.

Codes d’erreur

Les codes d’erreur suivants peuvent être retournés par les API XGameStreaming. Pour obtenir la liste complète, consultez Codes d’erreur.

Code	Valeur	Description
E_GAMESTREAMING_NOT_INITIALIZED	0x89245400	Le runtime XGameStreaming n’est pas initialisé. Appelez XGameStreamingInitialize avant d’appeler d’autres API.
E_GAMESTREAMING_CLIENT_NOT_CONNECTED	0x89245401	Le client spécifié n’est pas connecté.
E_GAMESTREAMING_NO_DATA	0x89245402	Les données demandées ne sont pas disponibles. Elles pourront l’être ultérieurement.
E_GAMESTREAMING_NO_DATACENTER	0x89245403	La machine actuelle ne s’exécute pas dans un centre de données.
E_GAMESTREAMING_NOT_STREAMING_CONTROLLER	0x89245404	La lecture actuelle ne provient pas d’une manette de streaming.

Documentation conceptuelle

Voir aussi

Référence des API système

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

XGameStreaming

XGameStreaming

Initialisation

Propriétés du client

Fonctions

Énumérations

Structures

État de la connexion

Fonctions

Énumérations

Latence

Fonctions

Emplacement du serveur

Fonctions

Adaptation tactile

Fonctions

Énumérations

Structures

Résolution

Fonctions

Codes d’erreur

Documentation conceptuelle

Voir aussi

​XGameStreaming

​Initialisation

​Propriétés du client

​Fonctions

​Énumérations

​Structures

​État de la connexion

​Fonctions

​Énumérations

​Latence

​Fonctions

​Emplacement du serveur

​Fonctions

​Adaptation tactile

​Fonctions

​Énumérations

​Structures

​Résolution

​Fonctions

​Codes d’erreur

​Documentation conceptuelle

​Voir aussi

XGameStreaming

Initialisation

Propriétés du client

Fonctions

Énumérations

Structures

État de la connexion

Fonctions

Énumérations

Latence

Fonctions

Emplacement du serveur

Fonctions

Adaptation tactile

Fonctions

Énumérations

Structures

Résolution

Fonctions

Codes d’erreur

Documentation conceptuelle

Voir aussi