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 entferntenRTCRtpReceiver
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
oderother
. 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 vongetStats()
. 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 |