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.
Das RTCOutboundRtpStreamStats
Wörterbuch der WebRTC API wird verwendet, um Metriken und Statistiken in Bezug auf einen ausgehenden RTP-Stream zu melden, der von einem RTCRtpSender
gesendet wird.
Die Statistiken können durch Iterieren des RTCStatsReport
, das von RTCPeerConnection.getStats()
oder RTCRtpSender.getStats()
zurückgegeben wird, bis Sie einen Bericht mit dem type
von outbound-rtp
finden, erhalten werden.
Instanzeigenschaften
averageRtcpInterval
-
Ein Fließkommawert, der das durchschnittliche RTCP-Intervall zwischen zwei aufeinanderfolgenden zusammengesetzten RTCP-Paketen angibt.
framesEncoded
-
Die Anzahl der Frames, die bisher erfolgreich zum Senden auf diesem RTP-Stream kodiert wurden. Nur gültig für Videostreams.
perDscpPacketsSent
-
Ein Datensatz von Schlüssel-Wert-Paaren mit Zeichenfolgen als Schlüssel, die auf 32-Bit-Ganzzahlen abgebildet sind, von denen jede die Gesamtanzahl der Pakete angibt, die dieser
RTCRtpSender
für diese Quelle für jeden Differentiated Services Code Point (DSCP) übertragen hat. qualityLimitationDurations
Experimentell-
Ein Datensatz, der jede der Qualitätsbeschränkungsgründe in der
RTCRemoteInboundRtpStreamStats
-Enumeration auf einen Fließkommawert abbildet, der die Anzahl der Sekunden angibt, die der Stream mit seiner Qualitätsbeschränkung für diesen Grund verbracht hat. qualityLimitationReason
Experimentell-
Eine der Zeichenfolgen
none
,cpu
,bandwidth
oderother
, die erklärt, warum die Auflösung und/oder Bildrate für diesen RTP-Stream begrenzt wird. Nur gültig für Videostreams. remoteId
-
Eine Zeichenfolge, die das
RTCRemoteInboundRtpStreamStats
-Objekt identifiziert, das Statistiken für den entfernten Peer für dasselbe SSRC bereitstellt. Diese ID bleibt stabil über mehrere Aufrufe vongetStats()
. retransmittedBytesSent
-
Die Gesamtzahl der Bytes, die zu diesem Zeitpunkt für diese Quelle erneut übertragen wurden, als die Statistiken erfasst wurden. Diese erneut übertragenen Bytes umfassen die Pakete, die im Wert zurückgegeben werden, den
retransmittedPacketsSent
liefert. retransmittedPacketsSent
-
Die Gesamtzahl der Pakete, die bis zum Zeitpunkt der Erfassung der Statistiken für diese Quelle erneut übertragen werden mussten. Diese erneut übertragenen Pakete sind im Wert enthalten, der von
packetsSent
zurückgegeben wird. senderId
-
Die
id
desRTCAudioSenderStats
oderRTCVideoSenderStats
-Objekts, das Statistiken über denRTCRtpSender
dieses Streams enthält. sliCount
-
Eine Ganzzahl, die angibt, wie oft dieser Sender von dem entfernten Peer einen Slice Loss Indication (SLI)-Frame erhalten hat, was darauf hinweist, dass ein oder mehrere aufeinanderfolgende Videomakroblöcke verloren gegangen oder beschädigt sind. Nur verfügbar für Videostreams.
targetBitrate
-
Ein Wert, der die Bitrate angibt, die der Codec des
RTCRtpSender
in seinem Ausgangsmedium zu erreichen versucht. totalEncodedBytesTarget
Experimentell-
Eine kumulative Summe der Ziel-Bildgrößen (der angestrebten maximalen Größe des Bildes in Bytes, wenn der Codec es komprimieren soll) für alle bisher kodierten Bilder. Dies wird sich wahrscheinlich von der Summe der tatsächlichen Bildgrößen unterscheiden.
totalEncodeTime
-
Ein Fließkommawert, der die Gesamtanzahl der Sekunden angibt, die bisher für das Kodieren der von diesem
RTCRtpSender
kodierten Bilder aufgewendet wurden. trackId
-
Die
id
desRTCSenderAudioTrackAttachmentStats
oderRTCSenderVideoTrackAttachmentStats
-Objekts, das die aktuelle Spurverbindung zumRTCRtpSender
enthält, der für diesen Stream verantwortlich ist.
Lokale Messungen
Diese Eigenschaften werden lokal berechnet und sind nur auf dem Gerät verfügbar, das den Medienstream empfängt. Ihr Hauptzweck ist es, die Fehlerresilienz der Verbindung zu untersuchen, da sie Informationen über verlorene Pakete, verlorene Frames und die Kompressionsstärke der Daten liefern.
nackCount
-
Ein Ganzzahlwert, der die Gesamtanzahl der negativen Empfangsbestätigungen (Negative ACKnowledgement, NACK) angibt, die dieser
RTCRtpSender
von dem entferntenRTCRtpReceiver
erhalten hat. qpSum
-
Ein 64-Bit-Wert, der die Summe der QP-Werte für jedes von diesem
RTCRtpSender
kodierte Bild enthält. Nur gültig für Videostreams.
Gemeinsame RTP-Stream-Statistiken
codecId
Optional-
Eine Zeichenfolge, die das Objekt eindeutig identifiziert, das untersucht wurde, um das
RTCCodecStats
-Objekt zu erzeugen, das mit diesem RTP-Stream assoziiert ist. kind
-
Eine Zeichenfolge, die angibt, ob der
MediaStreamTrack
, der mit dem Stream assoziiert ist, ein Audio- oder ein Videotrack ist. ssrc
-
Eine positive Ganzzahl, die die SSRC der RTP-Pakete in diesem Stream identifiziert.
transportId
Optional-
Eine Zeichenfolge, die das Objekt eindeutig identifiziert, das untersucht wurde, um das
RTCTransportStats
-Objekt zu erzeugen, das mit diesem RTP-Stream assoziiert ist.
Gemeinsame Instanzeigenschaften
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 Zeit 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.
Beispiele
Spezifikationen
Specification |
---|
Identifiers for WebRTC's Statistics API # dom-rtcstatstype-outbound-rtp |
Browser-Kompatibilität
BCD tables only load in the browser