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 melden, der von einem RTCRtpSender gesendet wird.

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

Instanz-Eigenschaften

active Experimentell

Ein Boolean, der anzeigt, ob dieser RTP-Stream zum Senden konfiguriert ist oder deaktiviert ist.

frameHeight

Ein Ganzzahlwert, der die Höhe des letzten kodierten Frames in Pixeln angibt. Nicht definiert für Audiostreams.

frameWidth

Ein Ganzzahlwert, der die Breite des letzten kodierten Frames in Pixeln angibt. Nicht definiert für Audiostreams.

framesEncoded

Die Anzahl der Frames, die bisher erfolgreich zum Senden auf diesem RTP-Stream kodiert wurden. Nicht definiert für Audiostreams.

framesPerSecond

Eine Zahl, die die im letzten Sekundenintervall gesendeten kodierten Frames darstellt. Nicht definiert für Audiostreams.

framesSent

Eine positive Ganzzahl, die die Gesamtanzahl der auf diesem RTP-Stream gesendeten kodierten Frames darstellt. Nicht definiert für Audiostreams.

headerBytesSent

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

keyFramesEncoded Experimentell

Eine positive Ganzzahl, die die Gesamtzahl der erfolgreich in diesem RTP-Medienstream kodierten Schlüsselbilder darstellt. Nicht definiert für Audiostreams.

mediaSourceId

Eine Zeichenfolge, die die ID des Statistikobjekts des Tracks darstellt, der derzeit am Sender dieses Streams angehängt ist.

mid

Eine Zeichenfolge, die das Paar aus Quelle und Ziel des Transceiver-Streams eindeutig identifiziert. Dies ist der Wert des 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 negativen Bestätigungspakete (NACK) angibt, die dieser RTCRtpSender vom entfernten RTCRtpReceiver erhalten hat. Dieser lokal berechnete Wert gibt einen Hinweis auf die Fehlerfestigkeit der Verbindung.

qpSum

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

qualityLimitationDurations Experimentell

Eine Zuordnung der Gründe, warum die Auflösung oder Bildrate eines Medienstreams reduziert wurde, und die Zeit, in der die Qualität aus jedem Grund reduziert wurde. Nicht definiert für Audiostreams.

qualityLimitationReason Experimentell

Eine Zeichenfolge, die den Grund angibt, warum der Stream qualitätsbegrenzt ist. Einer von: none, cpu, bandwidth oder other. Nicht definiert für Audiostreams.

remoteId

Eine Zeichenfolge, die das RTCRemoteInboundRtpStreamStats-Objekt identifiziert, das Statistiken für den entfernten Peer für diesen gleichen SSRC bereitstellt. Diese ID ist über mehrere Aufrufe von getStats() hinweg stabil.

retransmittedBytesSent

Eine positive Ganzzahl, die die Gesamtzahl der erneut gesendeten Payload-Bytes für die Quelle darstellt, die mit diesem Stream verbunden ist.

retransmittedPacketsSent

Eine positive Ganzzahl, die die Gesamtanzahl der erneut gesendeten Pakete für die Quelle darstellt, die mit diesem Stream verbunden ist.

rid

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

scalabilityMode Experimentell

Eine Zeichenfolge, 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 für das Kodieren der für diesen Stream kodierten Frames von RTCRtpSender aufgewendet wurden. Nicht definiert für Audiostreams.

totalEncodedBytesTarget Experimentell

Eine kumulative Summe der geplanten Frame-Größen für alle bisher kodierten Frames. Dies wird wahrscheinlich von der Summe der tatsächlichen Frame-Größen abweichen. Nicht definiert für Audiostreams.

totalPacketSendDelay

Eine Zahl, die die gesamte Zeit in Sekunden darstellt, die Pakete lokal gepuffert verbracht haben, bevor sie gesendet wurden.

Statistiken über gesendete RTP-Streams

bytesSent Optional

Eine positive Ganzzahl, die die Gesamtanzahl der für diesen SSRC gesendeten Bytes angibt, einschließlich erneuter Sendungen.

packetsSent Optional

Eine positive Ganzzahl, die die Gesamtanzahl der für diesen SSRC gesendeten RTP-Pakete angibt, einschließlich erneuter Sendungen.

Gemeinsame RTP-Stream-Statistiken

codecId Optional

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

kind

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

ssrc

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

transportId Optional

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

Gemeinsame Instanz-Eigenschaften

Die folgenden Eigenschaften sind allen WebRTC-Statistikobjekten gemeinsam.

id

Eine Zeichenfolge, die das Objekt eindeutig identifiziert, das überwacht wird, um diesen Satz von Statistiken zu erzeugen.

timestamp

Ein DOMHighResTimeStamp-Objekt, das die Uhrzeit angibt, zu der die Probe für dieses Statistikobjekt entnommen wurde.

type

Eine Zeichenfolge 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