Freigeben über

PartyEndpointStatistic

  • Artikel

Typen von Statistiken, die für einen Endpunkt abgerufen werden können.

Syntax

enum class PartyEndpointStatistic    
{  
    CurrentlyQueuedSendMessages = 0,  
    CurrentlyQueuedSendMessageBytes = 1,  
    CurrentlyActiveSendMessages = 2,  
    CurrentlyActiveSendMessageBytes = 3,  
    TimedOutSendMessages = 4,  
    TimedOutSendMessageBytes = 5,  
    CanceledSendMessages = 6,  
    CanceledSendMessageBytes = 7,  
    AverageDeviceRoundTripLatencyInMilliseconds = 8,  
}

Konstanten

Konstante Beschreibung
CurrentlyQueuedSendMessages Die Anzahl der Nachrichten, die derzeit von PartyLocalEndpoint::SendMessage() in die Warteschlange gestellt, aber noch nicht vom lokalen Endpunkt an die angegebenen Zielendpunkte übertragen werden.

Aus Effizienzgründen wird nur eine einzelne Nachricht von PartyLocalEndpoint::SendMessage() in die Warteschlange gestellt, wenn das Senden an mehrere Zielendpunkte gleichzeitig über den transparenten Cloudrelayserver erfolgt. Wenn beim Abfragen dieser Statistik zwei oder mehr dieser Endpunkte für PartyLocalEndpoint::GetEndpointStatistics() angegeben werden, wird die Nachricht nur einmal gezählt und nicht pro Zielendpunkt multipliziert.
CurrentlyQueuedSendMessageBytes Die Anzahl der Datenbytes in Nachrichten, die derzeit von PartyLocalEndpoint::SendMessage() in die Warteschlange gestellt, aber noch nicht vom lokalen Endpunkt an die angegebenen Zielendpunkte übertragen werden.

Aus Effizienzgründen wird nur eine einzelne Nachricht von PartyLocalEndpoint::SendMessage() in die Warteschlange gestellt, wenn das Senden an mehrere Zielendpunkte gleichzeitig über den transparenten Cloudrelayserver erfolgt. Wenn beim Abfragen dieser Statistik zwei oder mehr dieser Endpunkte für PartyLocalEndpoint::GetEndpointStatistics() angegeben werden, werden die Nachrichtenbytes nur einmal gezählt und nicht pro Zielendpunkt multipliziert.
CurrentlyActiveSendMessages Die Anzahl der PartyLocalEndpoint::SendMessage() -Nachrichten vom lokalen Endpunkt an die angegebenen Zielendpunkte, die derzeit übertragen werden oder noch weitere lokale Zustandsänderungen aufweisen, die verarbeitet werden sollen.

Eine Nachricht wird als "aktiv" betrachtet, sobald ihr erstes Byte in ein Paket eingefügt wurde, das übertragen wird. Sie bleibt aktiv, bis die Übertragung abgeschlossen ist und die lokale PartyDataBuffersReturnedStateChange für sie (falls zutreffend) an PartyManager::FinishProcessingStateChanges()zurückgegeben wurde.

Aus Effizienzgründen wird nur eine einzelne Nachricht pro PartyLocalEndpoint::SendMessage() nachverfolgt, wenn sie über den transparenten Cloudrelayserver gleichzeitig an mehrere Zielendpunkte gesendet wird. Wenn beim Abfragen dieser Statistik zwei oder mehr dieser Endpunkte für PartyLocalEndpoint::GetEndpointStatistics() angegeben werden, wird die Nachricht nur einmal gezählt und nicht pro Zielendpunkt multipliziert.
CurrentlyActiveSendMessageBytes Die Anzahl der Datenbytes in PartyLocalEndpoint::SendMessage() -Nachrichten vom lokalen Endpunkt an die angegebenen Zielendpunkte, die derzeit übertragen werden oder noch weitere lokale Zustandsänderungen aufweisen, die verarbeitet werden müssen.

Eine Nachricht wird als "aktiv" betrachtet, sobald ihr erstes Byte in ein Paket eingefügt wurde, das übertragen wird. Sie bleibt aktiv, bis die Übertragung abgeschlossen ist und die lokale PartyDataBuffersReturnedStateChange für sie (falls zutreffend) an PartyManager::FinishProcessingStateChanges()zurückgegeben wurde.

Aus Effizienzgründen wird nur eine einzelne Nachricht pro PartyLocalEndpoint::SendMessage() nachverfolgt, wenn sie über den transparenten Cloudrelayserver gleichzeitig an mehrere Zielendpunkte gesendet wird. Wenn beim Abfragen dieser Statistik zwei oder mehr dieser Endpunkte für PartyLocalEndpoint::GetEndpointStatistics() angegeben werden, werden die Nachrichtenbytes nur einmal gezählt und nicht pro Zielendpunkt multipliziert.
TimedOutSendMessages Die Gesamtanzahl der PartyLocalEndpoint::SendMessage() -Nachrichten vom lokalen Endpunkt an die angegebenen Zielendpunkte, die jemals verworfen wurden, weil die Timeouts der Sendewarteschlange überschritten wurden, ohne übertragen zu werden.

Das Timeout der Sendewarteschlange einer Nachricht wird mithilfe von PartySendMessageQueuingConfiguration::timeoutInMillseconds beim Aufrufen von PartyLocalEndpoint::SendMessage() angegeben.

Aus Effizienzgründen wird nur eine einzelne Nachricht von PartyLocalEndpoint::SendMessage() in die Warteschlange gestellt, wenn das Senden an mehrere Zielendpunkte gleichzeitig über den transparenten Cloudrelayserver erfolgt. Wenn beim Abfragen dieser Statistik zwei oder mehr dieser Endpunkte für PartyLocalEndpoint::GetEndpointStatistics() angegeben werden, wird die Nachricht nur einmal gezählt und nicht pro Zielendpunkt multipliziert.

Beachten Sie beim Abfragen dieser Statistik für alle Zielendpunkte durch Bereitstellen eines Nulleingabearrays für PartyLocalEndpoint::GetEndpointStatistics(), dass nur endpunkte einbezogen werden, die derzeit vorhanden sind. Wenn ein Endpunkt mit Timeoutnachrichten zwischen Abfragen zerstört wird, wird diese Anzahl möglicherweise als "rückwärts" wahrgenommen.
TimedOutSendMessageBytes Die Gesamtanzahl der Datenbytes in PartyLocalEndpoint::SendMessage() -Nachrichten vom lokalen Endpunkt an die angegebenen Zielendpunkte, die jemals verworfen wurden, weil sie ihre Sendewarteschlangentimeouts überschritten haben, ohne übertragen zu werden.

Das Timeout der Sendewarteschlange einer Nachricht wird mithilfe von PartySendMessageQueuingConfiguration::timeoutInMillseconds beim Aufrufen von PartyLocalEndpoint::SendMessage() angegeben.

Aus Effizienzgründen wird nur eine einzelne Nachricht von PartyLocalEndpoint::SendMessage() in die Warteschlange gestellt, wenn das Senden an mehrere Zielendpunkte gleichzeitig über den transparenten Cloudrelayserver erfolgt. Wenn beim Abfragen dieser Statistik zwei oder mehr dieser Endpunkte für PartyLocalEndpoint::GetEndpointStatistics() angegeben werden, werden die Nachrichtenbytes nur einmal gezählt und nicht pro Zielendpunkt multipliziert.

Beachten Sie beim Abfragen dieser Statistik für alle Zielendpunkte durch Bereitstellen eines Nulleingabearrays für PartyLocalEndpoint::GetEndpointStatistics(), dass nur endpunkte einbezogen werden, die derzeit vorhanden sind. Wenn ein Endpunkt mit Timeoutnachrichten zwischen Abfragen zerstört wird, wird diese Anzahl möglicherweise als "rückwärts" wahrgenommen.
CanceledSendMessages Die Gesamtzahl der PartyLocalEndpoint::SendMessage()- Nachrichten vom lokalen Endpunkt an die angegebenen Zielendpunkte, die jemals abgebrochen wurden.

Nachrichten werden abgebrochen, bevor sie von der Anwendung übertragen werden, die PartyLocalEndpoint::CancelMessages() mit einem übereinstimmenden Filterausdruck aufruft.

Aus Effizienzgründen wird nur eine einzelne Nachricht von PartyLocalEndpoint::SendMessage() in die Warteschlange gestellt, wenn sie über den transparenten Cloudrelayserver von PartyNetwork gleichzeitig an mehrere Zielendpunkte gesendet wird. Wenn beim Abfragen dieser Statistik zwei oder mehr dieser Endpunkte für PartyLocalEndpoint::GetEndpointStatistics() angegeben werden, wird die Nachricht nur einmal gezählt und nicht pro Zielendpunkt multipliziert.

Beachten Sie beim Abfragen dieser Statistik für alle Zielendpunkte durch Bereitstellen eines Nulleingabearrays für PartyLocalEndpoint::GetEndpointStatistics(), dass nur endpunkte einbezogen werden, die derzeit vorhanden sind. Wenn ein Endpunkt, für den Nachrichten abgebrochen wurden, zwischen Abfragen zerstört wird, wird diese Anzahl möglicherweise als "rückwärts" wahrgenommen.
CanceledSendMessageBytes Die Gesamtanzahl der Datenbytes in PartyLocalEndpoint::SendMessage() -Nachrichten vom lokalen Endpunkt an die angegebenen Zielendpunkte, die jemals abgebrochen wurden.

Nachrichten werden abgebrochen, bevor sie von der Anwendung übertragen werden, die PartyLocalEndpoint::CancelMessages() mit einem übereinstimmenden Filterausdruck aufruft.

Aus Effizienzgründen wird nur eine einzelne Nachricht von PartyLocalEndpoint::SendMessage() in die Warteschlange gestellt, wenn sie über den transparenten Cloudrelayserver von PartyNetwork gleichzeitig an mehrere Zielendpunkte gesendet wird. Wenn beim Abfragen dieser Statistik zwei oder mehr dieser Endpunkte für PartyLocalEndpoint::GetEndpointStatistics() angegeben werden, werden die Nachrichtenbytes nur einmal gezählt und nicht pro Zielendpunkt multipliziert.

Beachten Sie beim Abfragen dieser Statistik für alle Zielendpunkte durch Bereitstellen eines Nulleingabearrays für PartyLocalEndpoint::GetEndpointStatistics(), dass nur endpunkte einbezogen werden, die derzeit vorhanden sind. Wenn ein Endpunkt, für den Nachrichten abgebrochen wurden, zwischen Abfragen zerstört wird, wird diese Anzahl möglicherweise als "rückwärts" wahrgenommen.
AverageDeviceRoundTripLatencyInMilliseconds Die aktuelle gleitende durchschnittliche Roundtriplatenz ("Pingzeit") in Millisekunden bis zum eigenen Gerät des Endpunkts.

Diese Latenz stellt einen gleitenden Durchschnitt der Zeit dar, die dieses lokale Gerät derzeit benötigt, um eine Nachricht zu senden und eine Antwort vom Gerät des Zielendpunkts zu empfangen.

Diese Statistik kann jeweils nur für genau einen Zielendpunkt abgefragt werden. Die Methode PartyLocalEndpoint::GetEndpointStatistics() schlägt fehl, wenn mehrere Ziele bereitgestellt werden oder wenn ein Nulleingabearray bereitgestellt wird, um zu versuchen, alle aktuellen Endpunkte abzufragen.

Sie können auch die durchschnittliche Roundtriplatenz des lokalen Geräts zum transparenten Cloudrelayserver des Netzwerks ermitteln, indem Sie PartyNetwork::GetNetworkStatistics() verwenden, um die PartyNetworkStatistic::AverageRelayServerRoundTripLatencyInMilliseconds-Statistik abzurufen.

Voraussetzungen

Header: Party.h

Weitere Informationen

Party-Mitglieder
PartyNetworkStatistic
PartySendMessageQueuingConfiguration
PartyLocalEndpoint::SendMessage
PartyLocalEndpoint::GetEndpointStatistics
PartyNetwork::GetNetworkStatistics