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