PartyNetworkStatistic - XBOX Game Development Documentation

Types de statistiques pouvant être récupérées pour un réseau.

Syntaxe

enum class PartyNetworkStatistic    
{  
    AverageRelayServerRoundTripLatencyInMilliseconds = 0,  
    SentProtocolPackets = 1,  
    SentProtocolBytes = 2,  
    RetriedProtocolPackets = 3,  
    RetriedProtocolBytes = 4,  
    DroppedProtocolPackets = 5,  
    ReceivedProtocolPackets = 6,  
    ReceivedProtocolBytes = 7,  
    CurrentlyQueuedSendMessages = 8,  
    CurrentlyQueuedSendMessageBytes = 9,  
    CurrentlyActiveSendMessages = 10,  
    CurrentlyActiveSendMessageBytes = 11,  
    TimedOutSendMessages = 12,  
    TimedOutSendMessageBytes = 13,  
    CanceledSendMessages = 14,  
    CanceledSendMessageBytes = 15,  
}  

Constantes

Constante	Description
AverageRelayServerRoundTripLatencyInMilliseconds	La latence aller-retour moyenne mobile actuelle (« temps de ping »), en millisecondes, vers le serveur de relais cloud du réseau. Cette latence représente une moyenne mobile du temps actuellement nécessaire à cet appareil local pour envoyer un message et recevoir une réponse du serveur de relais cloud transparent. Vous pouvez également déterminer la latence aller-retour moyenne d’un point de terminaison local particulier vers un autre point de terminaison du réseau en utilisant PartyLocalEndpoint::GetEndpointStatistics() pour récupérer la statistique PartyEndpointStatistic::AverageDeviceRoundTripLatencyInMilliseconds.
SentProtocolPackets	Le nombre total de paquets du protocole interne transmis aux appareils distants dans le cadre de ce réseau. Cette statistique représente le nombre total de paquets du protocole interne transmis par l’appareil local pour n’importe quelle raison réseau. Elle inclut les paquets générés à la suite d’appels à PartyLocalEndpoint::SendMessage(), mais n’a pas nécessairement de correspondance un-à-un avec eux, car plusieurs petits messages peuvent être regroupés en un seul paquet, ou un message volumineux peut être fragmenté en plusieurs paquets selon la configuration et les facteurs environnementaux. En outre, des paquets peuvent être utilisés pour transporter le chat ou d’autres fonctionnalités internes de la bibliothèque (par exemple, des messages de prise en charge des opérations de l’API, des accusés de réception ou des nouvelles tentatives du protocole) pour le compte de l’application, sans appel explicite à PartyLocalEndpoint::SendMessage(). Cette statistique n’inclut pas les paquets générés pour les opérations de client web HTTP utilisées en interne par la bibliothèque Party pour certains aspects de l’authentification, des transactions de gestion, de la transcription de la parole en texte et de la synthèse vocale.
SentProtocolBytes	Le nombre total d’octets du protocole interne transmis aux appareils distants dans le cadre de ce réseau. Cette statistique représente le nombre total d’octets des paquets du protocole interne transmis par l’appareil local pour n’importe quelle raison réseau. Cette taille inclut les charges utiles de PartyLocalEndpoint::SendMessage(), mais aussi leur surcharge de protocole interne, ainsi que tout chat ou autre fonctionnalité interne de la bibliothèque nécessaire (par exemple, des messages de prise en charge des opérations de l’API, des accusés de réception ou des nouvelles tentatives du protocole) pour le compte de l’application, sans appel explicite à PartyLocalEndpoint::SendMessage(). La valeur indiquée n’inclut pas la surcharge des paquets des protocoles Internet (par exemple, UDP, IP) ni celle des supports de niveau inférieur sur lesquels fonctionne le protocole interne de la bibliothèque Party. Cette statistique n’inclut pas la taille des paquets générés pour les opérations de client web HTTP utilisées en interne par la bibliothèque Party pour certains aspects de l’authentification, des transactions de gestion, de la transcription de la parole en texte et de la synthèse vocale.
RetriedProtocolPackets	Le nombre total de paquets du protocole interne retransmis aux appareils distants dans le cadre de ce réseau. Cette statistique représente le nombre total de retransmissions de paquets du protocole interne effectuées par l’appareil local en raison de la perte apparente d’une tentative précédente dans l’environnement. La bibliothèque Party ne retente l’envoi que des paquets perdus contenant des messages d’application envoyés avec PartySendMessageOptions::GuaranteedDelivery ou des messages internes de la bibliothèque ayant des exigences de remise similaires. Cette statistique n’inclut pas les nouvelles tentatives de paquets générés pour les opérations de client web HTTP utilisées en interne par la bibliothèque Party pour certains aspects de l’authentification, des transactions de gestion, de la transcription de la parole en texte et de la synthèse vocale.
RetriedProtocolBytes	Le nombre total d’octets du protocole interne retransmis aux appareils distants dans le cadre de ce réseau. Cette statistique représente le nombre total d’octets des retransmissions de paquets du protocole interne effectuées par l’appareil local en raison de la perte apparente d’une tentative précédente dans l’environnement. Cette taille inclut les charges utiles des messages d’application envoyés avec PartySendMessageOptions::GuaranteedDelivery ou des messages internes de la bibliothèque ayant des exigences de remise similaires. La valeur indiquée n’inclut pas la surcharge des paquets retransmis des protocoles Internet (par exemple, UDP, IP) ni celle des supports de niveau inférieur sur lesquels fonctionne le protocole interne de la bibliothèque Party. Cette statistique n’inclut pas la taille des paquets retransmis générés pour les opérations de client web HTTP utilisées en interne par la bibliothèque Party pour certains aspects de l’authentification, des transactions de gestion, de la transcription de la parole en texte et de la synthèse vocale.
DroppedProtocolPackets	Le nombre total de paquets du protocole interne destinés aux appareils distants de ce réseau qui sont réputés avoir été perdus. Cette statistique représente le nombre total de transmissions de paquets du protocole interne tentées par l’appareil local mais qui semblent avoir subi une perte dans l’environnement. Elles peuvent avoir été retentées ou non (voir RetriedProtocolPackets). Cette statistique n’inclut pas les paquets perdus générés pour les opérations de client web HTTP utilisées en interne par la bibliothèque Party pour certains aspects de l’authentification, des transactions de gestion, de la transcription de la parole en texte et de la synthèse vocale.
ReceivedProtocolPackets	Le nombre total de paquets du protocole interne reçus des appareils distants dans le cadre de ce réseau. Cette statistique représente le nombre total de paquets du protocole interne reçus par l’appareil local pour n’importe quelle raison réseau, ce qui n’a pas de correspondance un-à-un avec les PartyEndpointMessageReceivedStateChange. Plusieurs petits messages peuvent être regroupés en un seul paquet, ou un message volumineux peut être fragmenté en plusieurs paquets selon la configuration et les facteurs environnementaux. En outre, des paquets peuvent être utilisés pour transporter le chat ou d’autres fonctionnalités internes de la bibliothèque (par exemple, des messages de prise en charge des opérations de l’API, des accusés de réception ou des nouvelles tentatives du protocole) pour le compte de l’application, sans appel explicite à PartyLocalEndpoint::SendMessage(). Cette statistique n’inclut pas les paquets reçus dans le cadre des opérations de client web HTTP utilisées en interne par la bibliothèque Party pour certains aspects de l’authentification, des transactions de gestion, de la transcription de la parole en texte et de la synthèse vocale.
ReceivedProtocolBytes	Le nombre total d’octets du protocole interne reçus des appareils distants dans le cadre de ce réseau. Cette statistique représente le nombre total d’octets des paquets du protocole interne reçus par l’appareil local pour n’importe quelle raison réseau. Cette taille inclut les charges utiles de PartyEndpointMessageReceivedStateChange, mais aussi leur surcharge de protocole interne, ainsi que tout chat ou autre fonctionnalité interne de la bibliothèque nécessaire (par exemple, des messages de prise en charge des opérations de l’API, des accusés de réception ou des nouvelles tentatives du protocole). La valeur indiquée n’inclut pas la surcharge des paquets des protocoles Internet (par exemple, UDP, IP) ni celle des supports de niveau inférieur sur lesquels fonctionne le protocole interne de la bibliothèque Party. Cette statistique n’inclut pas la taille des paquets reçus dans le cadre des opérations de client web HTTP utilisées en interne par la bibliothèque Party pour certains aspects de l’authentification, des transactions de gestion, de la transcription de la parole en texte et de la synthèse vocale.
CurrentlyQueuedSendMessages	Le nombre de messages actuellement mis en file d’attente par PartyLocalEndpoint::SendMessage() mais pas encore transmis de tous les points de terminaison locaux vers tous les points de terminaison distants du réseau. Par souci d’efficacité, un seul message est mis en file d’attente par PartyLocalEndpoint::SendMessage() lors d’un envoi simultané à plusieurs points de terminaison cibles via le serveur de relais cloud transparent. Ces messages ne sont comptés qu’une seule fois au lieu d’être multipliés par point de terminaison cible.
CurrentlyQueuedSendMessageBytes	Le nombre d’octets de données des messages actuellement mis en file d’attente par PartyLocalEndpoint::SendMessage() mais pas encore transmis de tous les points de terminaison locaux vers tous les points de terminaison distants du réseau. Par souci d’efficacité, un seul message est mis en file d’attente par PartyLocalEndpoint::SendMessage() lors d’un envoi simultané à plusieurs points de terminaison cibles via le serveur de relais cloud transparent. Les octets de ces messages ne sont comptés qu’une seule fois au lieu d’être multipliés par point de terminaison cible.
CurrentlyActiveSendMessages	Le nombre de messages PartyLocalEndpoint::SendMessage() de tous les points de terminaison locaux vers tous les points de terminaison distants du réseau qui sont en cours de transmission ou dont des changements d’état locaux restent à traiter. Un message est considéré comme « actif » dès que son premier octet a été placé dans un paquet en cours de transmission. Il reste actif jusqu’à la fin de la transmission et jusqu’à ce que le PartyDataBuffersReturnedStateChange local qui lui correspond (le cas échéant) ait été renvoyé à PartyManager::FinishProcessingStateChanges(). Par souci d’efficacité, un seul message est mis en file d’attente par PartyLocalEndpoint::SendMessage() lors d’un envoi simultané à plusieurs points de terminaison cibles via le serveur de relais cloud transparent. Ces messages ne sont comptés qu’une seule fois au lieu d’être multipliés par point de terminaison cible.
CurrentlyActiveSendMessageBytes	Le nombre d’octets de données des messages PartyLocalEndpoint::SendMessage() de tous les points de terminaison locaux vers tous les points de terminaison distants du réseau qui sont en cours de transmission ou dont des changements d’état locaux restent à traiter. Un message est considéré comme « actif » dès que son premier octet a été placé dans un paquet en cours de transmission. Il reste actif jusqu’à la fin de la transmission et jusqu’à ce que le PartyDataBuffersReturnedStateChange local qui lui correspond (le cas échéant) ait été renvoyé à PartyManager::FinishProcessingStateChanges(). Par souci d’efficacité, un seul message est mis en file d’attente par PartyLocalEndpoint::SendMessage() lors d’un envoi simultané à plusieurs points de terminaison cibles via le serveur de relais cloud transparent. Les octets de ces messages ne sont comptés qu’une seule fois au lieu d’être multipliés par point de terminaison cible.
TimedOutSendMessages	Le nombre total de messages PartyLocalEndpoint::SendMessage() de tous les points de terminaison locaux vers tous les points de terminaison distants du réseau qui ont été abandonnés pour avoir dépassé leur délai d’expiration de file d’attente d’envoi sans être transmis. Le délai d’expiration de file d’attente d’envoi d’un message est spécifié à l’aide de PartySendMessageQueuingConfiguration::timeoutInMillseconds lors de l’appel à PartyLocalEndpoint::SendMessage(). Par souci d’efficacité, un seul message est mis en file d’attente par PartyLocalEndpoint::SendMessage() lors d’un envoi simultané à plusieurs points de terminaison cibles via le serveur de relais cloud transparent. Ces messages ne sont comptés qu’une seule fois au lieu d’être multipliés par point de terminaison cible.
TimedOutSendMessageBytes	Le nombre total d’octets de données des messages PartyLocalEndpoint::SendMessage() de tous les points de terminaison locaux vers tous les points de terminaison distants du réseau qui ont été abandonnés pour avoir dépassé leur délai d’expiration de file d’attente d’envoi sans être transmis. Le délai d’expiration de file d’attente d’envoi d’un message est spécifié à l’aide de PartySendMessageQueuingConfiguration::timeoutInMillseconds lors de l’appel à PartyLocalEndpoint::SendMessage(). Par souci d’efficacité, un seul message est mis en file d’attente par PartyLocalEndpoint::SendMessage() lors d’un envoi simultané à plusieurs points de terminaison cibles via le serveur de relais cloud transparent. Les octets de ces messages ne sont comptés qu’une seule fois au lieu d’être multipliés par point de terminaison cible.
CanceledSendMessages	Le nombre total de messages PartyLocalEndpoint::SendMessage() de tous les points de terminaison locaux vers tous les points de terminaison distants du réseau qui ont été annulés. Les messages sont annulés avant leur transmission lorsque l’application appelle PartyLocalEndpoint::CancelMessages() avec une expression de filtre correspondante. Par souci d’efficacité, un seul message est mis en file d’attente par PartyLocalEndpoint::SendMessage() lors d’un envoi simultané à plusieurs points de terminaison cibles via le serveur de relais cloud transparent. Ces messages ne sont comptés qu’une seule fois au lieu d’être multipliés par point de terminaison cible.
CanceledSendMessageBytes	Le nombre total d’octets de données des messages PartyLocalEndpoint::SendMessage() de tous les points de terminaison locaux vers tous les points de terminaison distants du réseau qui ont été annulés. Les messages sont annulés avant leur transmission lorsque l’application appelle PartyLocalEndpoint::CancelMessages() avec une expression de filtre correspondante. Par souci d’efficacité, un seul message est mis en file d’attente par PartyLocalEndpoint::SendMessage() lors d’un envoi simultané à plusieurs points de terminaison cibles via le serveur de relais cloud transparent. Les octets de ces messages ne sont comptés qu’une seule fois au lieu d’être multipliés par point de terminaison cible.

Configuration requise

En-tête : Party.h

Voir aussi

Membres de Party
PartyEndpointStatistic
PartySendMessageOptions
PartyNetwork::GetNetworkStatistics
PartyLocalEndpoint::SendMessage
PartyLocalEndpoint::GetEndpointStatistics

Dernière modification le 8 octobre 2026

⌘I