RTCDataChannelStats
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Das RTCDataChannelStats-Wörterbuch der WebRTC API liefert Statistiken, die mit einem RTCDataChannel-Objekt auf der Verbindung in Zusammenhang stehen.
Der Bericht kann erhalten werden, indem der RTCStatsReport itereiert wird, der von RTCPeerConnection.getStats() zurückgegeben wird, bis Sie einen Eintrag mit dem type data-channel finden.
Die Datenkanalstatistiken können einem bestimmten Kanal zugeordnet werden, indem die dataChannelIdentifier-Eigenschaft mit einer passenden RTCDataChannel.id verglichen wird.
Instanz-Eigenschaften
bytesSentOptional-
Ein positiver Ganzzahlwert, der die Gesamtanzahl der Nutzlast-Bytes angibt, die über den zugehörigen
RTCDataChannelgesendet wurden. bytesReceivedOptional-
Ein positiver Ganzzahlwert, der die Gesamtanzahl der Nutzlast-Bytes angibt, die über den zugehörigen
RTCDataChannelempfangen wurden. dataChannelIdentifierOptional-
Ein positiver Ganzzahlwert, der die
iddes zugehörigenRTCDataChannelenthält. labelOptional-
Ein String, der das
labeldes zugehörigenRTCDataChannelenthält. messagesReceivedOptional-
Ein positiver Ganzzahlwert, der die Gesamtanzahl der
messageevents angibt, die für empfangene Nachrichten auf dem zugehörigenRTCDataChannelausgelöst wurden. messagesSentOptional-
Ein positiver Ganzzahlwert, der die Gesamtanzahl der
messageevents angibt, die für gesendete Nachrichten auf dem Kanal ausgelöst wurden. protocolOptional-
Ein String, der das
protocoldes zugehörigenRTCDataChannelenthält. state-
Der
readyStatedes zugehörigenRTCDataChannel.
Gemeinsame Instanz-Eigenschaften
Die folgenden Eigenschaften sind allen WebRTC-Statistikobjekten gemeinsam (siehe RTCStatsReport für weitere Informationen).
id-
Ein String, der das Objekt eindeutig identifiziert, das überwacht wird, um diesen Satz von Statistiken zu erzeugen.
timestamp-
Ein
DOMHighResTimeStamp-Objekt, das den Zeitpunkt angibt, zu dem die Probe für dieses Statistikobjekt entnommen wurde. type-
Ein String mit dem Wert
"data-channel", der den Typ der Statistiken angibt, den das Objekt enthält.
Beispiele
Gegeben sei eine Variable myPeerConnection, die eine Instanz von RTCPeerConnection ist. Der nachfolgende Code verwendet await, um auf den Statistikbericht zu warten, und durchläuft ihn dann mit RTCStatsReport.forEach().
Er filtert die Wörterbücher heraus, die nur Berichte vom Typ data-channel haben, und protokolliert das Ergebnis.
const stats = await myPeerConnection.getStats();
stats.forEach((report) => {
if (report.type === "data-channel") {
// Log the channel information
console.log(report);
}
});
Spezifikationen
| Specification |
|---|
| Identifiers for WebRTC's Statistics API # dom-rtcstatstype-data-channel |
Browser-Kompatibilität
Loading…