RTCOutboundRtpStreamStats

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 RTCOutboundRtpStreamStats-Wörterbuch der WebRTC API wird verwendet, um Metriken und Statistiken im Zusammenhang mit einem ausgehenden RTP-Stream zu berichten, der von einem RTCRtpSender gesendet wird.

Die Statistiken können durch Iteration über den RTCStatsReport, der von RTCPeerConnection.getStats() oder RTCRtpSender.getStats() zurückgegeben wird, abgerufen werden, bis Sie einen Bericht mit dem type outbound-rtp finden.

Instanz-Eigenschaften

active Experimentell

Ein Boolean-Wert, der angibt, ob dieser RTP-Stream konfiguriert ist, gesendet zu werden, oder ob er deaktiviert ist.

frameHeight

Ein Integer, der die Höhe des letzten codierten Frames in Pixeln angibt. Nicht definiert für Audio-Streams.

frameWidth

Ein Integer, der die Breite des letzten codierten Frames in Pixeln angibt. Nicht definiert für Audio-Streams.

framesEncoded

Die Anzahl der Frames, die bisher erfolgreich für diesen RTP-Stream codiert wurden. Nicht definiert für Audio-Streams.

framesPerSecond

Eine Zahl, die die in der letzten Sekunde gesendeten codierten Frames darstellt. Nicht definiert für Audio-Streams.

framesSent

Eine positive ganze Zahl, die die Gesamtanzahl der auf diesem RTP-Stream gesendeten codierten Frames darstellt. Nicht definiert für Audio-Streams.

headerBytesSent

Eine positive ganze Zahl, die die Anzahl der gesendeten RTP-Header- und Padding-Bytes für diesen SSRC darstellt.

keyFramesEncoded Experimentell

Eine positive ganze Zahl, die die Gesamtanzahl der erfolgreich in diesem RTP-Medienstream codierten Schlüsselbilder darstellt. Nicht definiert für Audio-Streams.

mediaSourceId

Ein String, der die ID des Statistik-Objekts der Spur darstellt, die derzeit an den Sender dieses Streams angehängt ist.

mid

Ein String, der die Zuordnung von Quelle und Ziel des Streams des Transceivers eindeutig identifiziert. Dies ist der Wert des entsprechenden RTCRtpTransceiver.mid, es sei denn, dieser ist null, in welchem Fall die Statistik-Eigenschaft nicht vorhanden ist.

nackCount

Ein Integer-Wert, der die Gesamtanzahl der Negative ACKnowledgement (NACK)-Pakete angibt, die dieser RTCRtpSender vom entfernten RTCRtpReceiver erhalten hat. Dieser lokal berechnete Wert gibt einen Hinweis auf die Fehlerresistenz der Verbindung.

qpSum

Ein 64-Bit-Wert, der die Summe der QP-Werte für jedes von diesem RTCRtpSender codierte Frame enthält. Dieser lokal berechnete Wert gibt einen Hinweis darauf, wie stark die Daten komprimiert sind. Nicht definiert für Audio-Streams.

qualityLimitationDurations Experimentell

Eine Map mit den Gründen, warum die Auflösung oder Bildrate eines Medienstreams reduziert wurde, und der Zeit, für die die Qualität aus jedem Grund reduziert wurde. Nicht definiert für Audio-Streams.

qualityLimitationReason Experimentell

Ein String, der den Grund angibt, warum der Stream qualitätsbegrenzt ist. Einer von: none, cpu, bandwidth oder other. Nicht definiert für Audio-Streams.

remoteId

Ein String, der das RTCRemoteInboundRtpStreamStats-Objekt identifiziert, das Statistiken für den entfernten Peer für diesen SSRC bereitstellt. Diese ID bleibt über mehrere Aufrufe von getStats() stabil.

retransmittedBytesSent

Eine positive ganze Zahl, die die Gesamtzahl der erneut gesendeten Nutzlastbytes für die Quelle darstellt, die mit diesem Stream verknüpft ist.

retransmittedPacketsSent

Eine positive ganze Zahl, die die Gesamtanzahl der erneut gesendeten Pakete für die Quelle darstellt, die mit diesem Stream verknüpft ist.

rid

Ein String, der die RTP-Stream-ID für einen entsprechenden Videostream angibt.

scalabilityMode Experimentell

Ein String, der den Skalierbarkeitsmodus für den RTP-Stream darstellt, falls einer konfiguriert wurde.

targetBitrate

Eine Zahl, die die Bitrate darstellt, die der Codec des RTCRtpSender derzeit für den Stream zu erreichen versucht.

totalEncodeTime

Eine Zahl, die die Gesamtanzahl der Sekunden angibt, die für das Codieren der für diesen Stream codierten Frames durch den RTCRtpSender aufgewendet wurden. Nicht definiert für Audio-Streams.

totalEncodedBytesTarget Experimentell

Eine kumulative Summe der Ziel-Frame-Größen aller bisher codierten Frames. Diese wird sich wahrscheinlich von der Summe der tatsächlichen Frame-Größen unterscheiden. Nicht definiert für Audio-Streams.

totalPacketSendDelay

Eine Zahl, die die Gesamtzeit in Sekunden angibt, die Pakete gepuffert waren, bevor sie lokal gesendet wurden.

Gesendete RTP-Stream-Statistiken

bytesSent Optional

Eine positive ganze Zahl, die die Gesamtanzahl der für diesen SSRC gesendeten Bytes, einschließlich Wiederholungen, angibt.

packetsSent Optional

Eine positive ganze Zahl, die die Gesamtanzahl der für diesen SSRC gesendeten RTP-Pakete, einschließlich Wiederholungen, angibt.

Gemeinsame RTP-Stream-Statistiken

codecId Optional

Ein String, der das Objekt eindeutig identifiziert, das überprüft wurde, um das RTCCodecStats-Objekt zu erstellen, das mit diesem RTP-Stream verknüpft ist.

kind

Ein String, der angibt, ob der mit dem Stream verknüpfte MediaStreamTrack eine Audio- oder Video-Spur ist.

ssrc

Eine positive ganze Zahl, die den SSRC der RTP-Pakete in diesem Stream identifiziert.

transportId Optional

Ein String, der das Objekt eindeutig identifiziert, das überprüft wurde, um das RTCTransportStats-Objekt zu erstellen, das mit diesem RTP-Stream verknüpft ist.

Gemeinsame Instanz-Eigenschaften

Die folgenden Eigenschaften sind allen WebRTC-Statistik-Objekten gemeinsam.

id

Ein String, der das Objekt, das überwacht wird, um diese Statistik zu erstellen, eindeutig identifiziert.

timestamp

Ein DOMHighResTimeStamp-Objekt, das den Zeitpunkt angibt, zu dem die Messung für dieses Statistik-Objekt durchgeführt wurde.

type

Ein String mit dem Wert "outbound-rtp", der den Typ der im Objekt enthaltenen Statistiken angibt.

Beispiele

Spezifikationen

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

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
outbound-rtp stats
active in 'outbound-rtp' stats
Experimental
bytesSent in 'outbound-rtp' stats
codecId in 'outbound-rtp' stats
frameHeight in 'outbound-rtp' stats
frameWidth in 'outbound-rtp' stats
framesEncoded in 'outbound-rtp' stats
framesPerSecond in 'outbound-rtp' stats
framesSent in 'outbound-rtp' stats
headerBytesSent in 'outbound-rtp' stats
id in 'outbound-rtp' stats
keyFramesEncoded in 'outbound-rtp' stats
Experimental
kind in 'outbound-rtp' stats
mediaSourceId in 'outbound-rtp' stats
mid in 'outbound-rtp' stats
nackCount in 'outbound-rtp' stats
packetsSent in 'outbound-rtp' stats
qpSum in 'outbound-rtp' stats
qualityLimitationDurations in 'outbound-rtp' stats
Experimental
qualityLimitationReason in 'outbound-rtp' stats
Experimental
remoteId in 'outbound-rtp' stats
retransmittedBytesSent in 'outbound-rtp' stats
retransmittedPacketsSent in 'outbound-rtp' stats
rid in 'outbound-rtp' stats
scalabilityMode in 'outbound-rtp' stats
Experimental
ssrc in 'outbound-rtp' stats
targetBitrate in 'outbound-rtp' stats
timestamp in 'outbound-rtp' stats
totalEncodeTime in 'outbound-rtp' stats
totalEncodedBytesTarget in 'outbound-rtp' stats
Experimental
totalPacketSendDelay in 'outbound-rtp' stats
transportId in 'outbound-rtp' stats
type in 'outbound-rtp' stats

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.

Siehe auch