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 oder other, 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 von getStats().

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 des RTCAudioSenderStats oder RTCVideoSenderStats-Objekts, das Statistiken über den RTCRtpSender 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 des RTCSenderAudioTrackAttachmentStats oder RTCSenderVideoTrackAttachmentStats-Objekts, das die aktuelle Spurverbindung zum RTCRtpSender 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 entfernten RTCRtpReceiver 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

Siehe auch