XGameStreamingGetStreamAddedLatency
Obtient la moyenne récente de la latence liée à la diffusion en continu.Syntaxe
Paramètres
client _In_Type : XGameStreamingClientId Appareil client de diffusion en continu pour lequel la latence est interrogée. averageInputLatencyUs _Out_
Type : uint32_t* Latence moyenne, en microsecondes, sur une période récente, pour que l’entrée soit reçue par le jeu XBOX. averageOutputLatencyUs _Out_
Type : uint32_t* Latence moyenne, en microsecondes, sur une période récente, pour qu’une image du jeu soit rendue sur l’appareil client. standardDeviationUs _Out_
Type : uint32_t* Moyenne observée de l’écart-type mesuré de la gigue de la latence, en microsecondes, sur une période récente.
Valeur de retour
Type : HRESULT Retourne S_OK en cas de réussite; sinon, retourne un code d’erreur.Erreurs potentielles
Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur.
Remarques
Cette fonction ne peut pas être appelée de façon sécuritaire sur un thread sensible au temps. Pour plus d’informations, consultez Threads sensibles au temps.
Comme expliqué ci-dessous, les valeurs de latence d’entrée et de sortie mesurent des éléments différents et peuvent être calculées à partir de sources différentes. Ces valeurs ne sont pas censées être similaires et doivent être traitées indépendamment.
XGameStreamingGetStreamAddedLatency fournit des données sur la latence mesurée attribuable à la diffusion en continu du jeu. Les jeux peuvent les utiliser pour mieux comprendre l’expérience que vit le joueur avec la diffusion en continu.
Il est important de noter que cette fonction ne fournit pas la latence complète de bout en bout que peut remarquer un joueur (par exemple, elle ne correspond pas directement au délai entre l’appui sur un bouton d’une manette connectée à l’appareil client de diffusion en continu et le rendu d’une nouvelle image qui en tient compte). Par exemple, les composants suivants ne sont pas inclus dans ces mesures :
- Temps de rendu du moteur de jeu
- Temps écoulé entre la transmission pour le rendu sur l’appareil client et le moment où le joueur voit l’image
- Temps de transport et de décodage Bluetooth® depuis la manette sur l’appareil client
- Le temps nécessaire à l’application de diffusion de jeux en continu pour traiter les entrées reçues d’une manette.
- Le temps de transmission de l’application de diffusion de jeux en continu, sur le réseau, jusqu’au serveur qui exécute le jeu.
- Le temps d’encodage de chaque image rendue par le titre.
- Le temps de transmission de cette image sur le réseau jusqu’à l’application avec laquelle le joueur interagit.
- Le temps de décodage dans l’application, pendant qu’elle se prépare à présenter l’image au joueur.
XGameStreamingGetStreamAddedLatency est une mesure moyenne mise à jour toutes les quelques secondes. Pour des mesures plus précises, l’API XGameStreamingGetAssociatedFrame peut être utilisée. Pour plus d’informations, consultez Présentation approfondie de la compensation de latence pour la diffusion de jeux en continu.
Configuration requise
En-tête : xgamestreaming.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX SeriesDocumentation conceptuelle
- Présentation approfondie de la compensation de latence pour la diffusion de jeux en continu
- Threads sensibles au temps
Voir aussi
XGameStreamingVue d’ensemble de la compensation de latence pour la diffusion de jeux en continu