RTCRemoteOutboundRtpStreamStats

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

* Some parts of this feature may have varying levels of support.

Das RTCRemoteOutboundRtpStreamStats-Wörterbuch der WebRTC API wird verwendet, um Statistiken von einem entfernten Endpunkt über seinen ausgehenden RTP-Stream zu melden. Dies entspricht einem eingehenden Stream, der derzeit vom lokalen RTCPeerConnection-Objekt empfangen wird.

Die Statistiken können abgerufen werden, indem Sie das RTCStatsReport iterieren, das von RTCPeerConnection.getStats() zurückgegeben wird, bis Sie einen Bericht mit dem type von remote-outbound-rtp finden.

Instanz-Eigenschaften

Spezielle Statistiken für entfernten ausgehenden Stream

localId Optional: Ein String, der verwendet wird, um das lokale RTCInboundRtpStreamStats-Objekt zu finden, das dieselbe Synchronisationsquelle (SSRC) teilt.
remoteTimestamp Optional: Ein DOMHighResTimeStamp, der den Zeitstempel (auf dem entfernten Gerät) angibt, zu dem die Statistiken im RTCRemoteOutboundRtpStreamStats-Objekt vom entfernten Endpunkt gesendet wurden. Dies unterscheidet sich vom timestamp; er repräsentiert die Zeit, zu der die Statistiken des Objekts am lokalen Endpunkt empfangen oder erstellt wurden.
reportsSent Optional Experimentell: Eine positive Ganzzahl, die die Gesamtanzahl der gesendeten RTCP-Sender-Report-Blöcke (SR) für diese Synchronisationsquelle (SSRC) angibt.
roundTripTimeMeasurements Optional Experimentell: Eine positive Zahl, die die Gesamtanzahl der empfangenen gültigen Round-Trip-Time-Messungen für diese Synchronisationsquelle (SSRC) repräsentiert.
totalRoundTripTime Optional Experimentell: Eine Zahl, die die kumulative Summe aller Round-Trip-Time-Messungen seit Beginn der Sitzung in Sekunden angibt. Die durchschnittliche Round-Trip-Time kann berechnet werden, indem totalRoundTripTime durch roundTripTimeMeasurements geteilt wird.

Gesendete RTP-Stream-Statistiken

bytesSent Optional: Eine positive Ganzzahl, die die Gesamtanzahl der für dieses SSRC gesendeten Bytes, einschließlich der neuen Übertragungen, angibt.
packetsSent Optional: Eine positive Ganzzahl, die die Gesamtanzahl der für dieses SSRC gesendeten RTP-Pakete, einschließlich der neuen Übertragungen, angibt.

Allgemeine RTP-Stream-Statistiken

codecId Optional: Ein String, der das Objekt eindeutig identifiziert, das inspiziert wurde, um den RTCCodecStats-Bericht zu erzeugen, der mit diesem RTP-Stream verbunden ist.
kind: Ein String, der angibt, ob der MediaStreamTrack, der mit dem Stream verbunden ist, ein Audio- oder ein Videospur ist.
ssrc: Eine positive Ganzzahl, die die Synchronisationsquelle (SSRC) der RTP-Pakete in diesem Stream identifiziert.
transportId Optional: Ein String, der das Objekt eindeutig identifiziert, das inspiziert wurde, um den RTCTransportStats-Bericht zu erzeugen, der mit diesem RTP-Stream verbunden ist.

Allgemeine Instanz-Eigenschaften

Die folgenden Eigenschaften sind allen WebRTC-Statistikobjekten gemeinsam.

id: Ein String, der das Objekt eindeutig identifiziert, das überwacht wird, um diesen Satz von Statistiken zu erzeugen.
timestamp: Ein DOMHighResTimeStamp-Objekt, das die Zeit angibt, zu der die Stichprobe für dieses Statistikobjekt entnommen wurde.
type: Ein String mit dem Wert "remote-outbound-rtp", der den Typ der Statistiken angibt, die das Objekt enthält.

Nutzungshinweise

Die RTCRemoteOutboundRtpStreamStats-Objekteigenschaft remoteTimestamp bietet Statistiken basierend auf dem NTP-Zeitstempel der empfangenen Daten, entnommen aus einem RTCP-Sender-Report-Block (SR). Seien Sie sich bewusst, dass die entfernte Uhr möglicherweise nicht mit der lokalen Uhr synchronisiert ist (weder in der aktuellen Zeit noch in der Geschwindigkeit, mit der die Zeit vergeht).

Spezifikationen

Specification
Identifiers for WebRTC's Statistics API # dom-rtcstatstype-remote-outbound-rtp