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 zu einem ausgehenden RTP-Stream zu berichten, der von einem RTCRtpSender gesendet wird.

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

Instanzen-Eigenschaften

active Experimentell

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

frameHeight

Ein Ganzzahlwert, der die Höhe des letzten kodierten Rahmens in Pixeln angibt. Nicht definiert für Audio-Streams.

frameWidth

Ein Ganzzahlwert, der die Breite des letzten kodierten Rahmens in Pixeln angibt. Nicht definiert für Audio-Streams.

framesEncoded

Die Anzahl der Rahmen, die bisher erfolgreich kodiert wurden, um über diesen RTP-Stream gesendet zu werden. Nicht definiert für Audio-Streams.

framesPerSecond

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

framesSent

Eine positive Ganzzahl, die die Gesamtanzahl der über diesen RTP-Stream gesendeten kodierten Rahmen darstellt. Nicht definiert für Audio-Streams.

headerBytesSent

Eine positive Ganzzahl, die die Gesamtanzahl der für diese SSRC gesendeten RTP-Header- und Padding-Bytes darstellt.

keyFramesEncoded Experimentell

Eine positive Ganzzahl, die die Gesamtanzahl der Schlüsselbilder darstellt, die in diesem RTP-Medienstrom erfolgreich kodiert wurden. Nicht definiert für Audio-Streams.

mediaSourceId

Eine Zeichenkette, die die ID des Statistikobjekts der aktuell an den Sender dieses Streams angeschlossenen Spur darstellt.

mid

Eine Zeichenkette, die das Paar aus Quelle und Ziel des Streams des Transceivers eindeutig identifiziert. Dies ist der Wert der entsprechenden RTCRtpTransceiver.mid, es sei denn, dieser ist null, in diesem Fall ist die Statistik-Eigenschaft nicht vorhanden.

nackCount

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

qpSum

Ein 64-Bit-Wert, der die Summe der QP-Werte für jeden von diesem RTCRtpSender kodierten Rahmen 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 Karte der Gründe, warum die Auflösung oder Framerate eines Medienstroms reduziert wurde, und die Zeit, die die Qualität für jeden Grund reduziert war. Nicht definiert für Audio-Streams.

qualityLimitationReason Experimentell

Eine Zeichenkette, die den Grund dafür angibt, warum der Stream qualitätslimitiert ist. Einer von: none, cpu, bandwidth oder other. Nicht definiert für Audio-Streams.

remoteId

Eine Zeichenkette, die das RTCRemoteInboundRtpStreamStats-Objekt identifiziert, das Statistiken für den entfernten Partner für diese gleiche SSRC bereitstellt. Diese ID ist stabil über mehrere Aufrufe von getStats().

retransmittedBytesSent

Eine positive Ganzzahl, die die Gesamtanzahl der für die mit diesem Stream verbundene Quelle retransmittierten Nutzlastbytes darstellt.

retransmittedPacketsSent

Eine positive Ganzzahl, die die Gesamtanzahl der für die mit diesem Stream verbundene Quelle retransmittierten Pakete darstellt.

rid

Eine Zeichenkette, die die RTP-Stream-ID für einen entsprechenden Videostream angibt.

scalabilityMode Experimentell

Eine Zeichenkette, die 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 versucht, für den Stream zu erreichen.

totalEncodeTime

Eine Zahl, die die Gesamtanzahl der Sekunden darstellt, die mit dem Kodieren der für diesen Stream kodierten Rahmen RTCRtpSender verbracht wurden. Nicht definiert für Audio-Streams.

totalEncodedBytesTarget Experimentell

Eine kumulative Summe der Ziel-Rahmengrößen für alle bisher kodierten Rahmen. Dies wird sich wahrscheinlich von der Summe der tatsächlichen Rahmengrößen unterscheiden. Nicht definiert für Audio-Streams.

totalPacketSendDelay

Eine Zahl, die die Gesamtzeit in Sekunden darstellt, die Pakete lokal gepuffert verbracht haben, bevor sie übertragen wurden.

Gesendete RTP-Stream-Statistiken

bytesSent Optional

Eine positive Ganzzahl, die die Gesamtanzahl der für diese SSRC gesendeten Bytes darstellt, einschließlich Retransmissionen.

packetsSent Optional

Eine positive Ganzzahl, die die Gesamtanzahl der für diese SSRC gesendeten RTP-Pakete darstellt, einschließlich Retransmissionen.

Gemeinsame RTP-Stream-Statistiken

codecId Optional

Eine Zeichenkette, die das Objekt eindeutig identifiziert, das untersucht wurde, um das RTCCodecStats-Objekt zu erzeugen, das mit diesem RTP-Stream verbunden ist.

kind

Eine Zeichenkette, die angibt, ob der mit dem Stream verbundene MediaStreamTrack ein Audio- oder ein Videospur ist.

ssrc

Eine positive Ganzzahl, die die SSRC der RTP-Pakete in diesem Stream identifiziert.

transportId Optional

Eine Zeichenkette, die das Objekt eindeutig identifiziert, das untersucht wurde, um das RTCTransportStats-Objekt zu erzeugen, das mit diesem RTP-Stream verbunden ist.

Gemeinsame Instanzen-Eigenschaften

Die folgenden Eigenschaften sind allen WebRTC-Statistikobjekten gemeinsam.

id

Eine Zeichenkette, die 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 gemacht wurde.

type

Eine Zeichenkette mit dem Wert "outbound-rtp", die den Typ der Statistiken angibt, die das Objekt enthält.

Spezifikationen

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

Browser-Kompatibilität

Siehe auch