RTCOutboundRtpStreamStats

Das RTCOutboundRtpStreamStats-Wörterbuch der WebRTC-API wird verwendet, um Metriken und Statistiken im Zusammenhang mit einem ausgehenden RTP-Stream zu melden, der von einem RTCRtpSender gesendet wird.

Die Statistiken können gewonnen 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.

Instanz-Eigenschaften

Das RTCOutboundRtpStreamStats-Wörterbuch umfasst die folgenden Eigenschaften zusätzlich zu denen, die es von RTCSentRtpStreamStats und RTCRtpStreamStats erbt.

averageRtcpInterval

Ein Gleitkommawert, der das durchschnittliche RTCP-Intervall zwischen zwei aufeinanderfolgenden RTCP-Paketen angibt.

firCount

Ein ganzzahliger Wert, der die Gesamtanzahl der Full Intra Request (FIR)-Pakete angibt, die dieser RTCRtpSender an den entfernten RTCRtpReceiver gesendet hat. Dies ist ein Indikator dafür, wie oft der Stream verzögert wurde, was das Überspringen von Frames erfordert, um aufzuholen. Gültig nur für Video-Streams.

framesEncoded

Die Anzahl der Frames, die bisher erfolgreich für die Übertragung auf diesem RTP-Stream kodiert wurden. Nur gültig für Video-Streams.

nackCount

Ein ganzzahliger Wert, der die Gesamtanzahl der Negative ACKnowledgement (NACK)-Pakete angibt, die dieser RTCRtpSender vom entfernten RTCRtpReceiver erhalten hat.

perDscpPacketsSent

Ein Datensatz mit Schlüssel-Wert-Paaren, wobei Strings als Schlüssel mit 32-Bit-Ganzzahlen als Wert gemappt werden und jeweils die Gesamtanzahl der Pakete angeben, die dieser RTCRtpSender für diese Quelle für jeden Differentiated Services Code Point (DSCP) übertragen hat.

pliCount

Eine Ganzzahl, die angibt, wie oft der entfernte Empfänger diesem RTCRtpSender mitgeteilt hat, dass eine Menge von kodierten Videodaten für ein oder mehrere Frames verloren gegangen ist, unter Verwendung von Picture Loss Indication (PLI)-Paketen. Nur verfügbar für Video-Streams.

qpSum

Ein 64-Bit-Wert, der die Summe der QP-Werte für jeden Frame enthält, der von diesem RTCRtpSender kodiert wurde. Gültig nur für Video-Streams.

qualityLimitationDurations Experimentell

Ein Datensatz, der jeden der Gründe für die Qualitätsbegrenzung, wie sie in der RTCRemoteInboundRtpStreamStats-Enumeration beschrieben sind, auf einen Gleitkommawert abbildet, der die Anzahl der Sekunden angibt, die der Stream wegen dieses Grundes mit begrenzter Qualität verbracht hat.

qualityLimitationReason Experimentell

Einer der Strings none, cpu, bandwidth oder other, der erklärt, warum die Auflösung und/oder die Bildrate für diesen RTP-Stream begrenzt wird. Gültig nur für Video-Streams.

remoteId

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

retransmittedBytesSent

Die Gesamtanzahl der Bytes, die für diese Quelle zum Zeitpunkt der Stichprobenentnahme der Statistik erneut übertragen wurden. Diese erneut übertragenen Bytes umfassen die Pakete, die in dem Wert enthalten sind, der von retransmittedPacketsSent zurückgegeben wird.

retransmittedPacketsSent

Die Gesamtzahl der Pakete, die für diese Quelle zum Zeitpunkt der Stichprobenentnahme der Statistik 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 diesen Stream's RTCRtpSender enthält.

sliCount

Eine Ganzzahl, die angibt, wie oft dieser Sender einen Slice Loss Indication (SLI)-Frame vom entfernten Peer erhalten hat, der anzeigt, dass ein oder mehrere aufeinanderfolgende Videomakroblöcke verloren oder beschädigt wurden. Nur für Video-Streams verfügbar.

targetBitrate

Ein Wert, der die Bitrate angibt, die der Codec des RTCRtpSender zu erreichen versucht, in der ausgehenden Medienausgabe.

totalEncodedBytesTarget Experimentell

Eine kumulative Summe der Ziel-Frame-Größen (die angestrebte maximale Größe des Frames in Bytes, wenn der Codec gebeten wird, ihn zu komprimieren) für alle bisher kodierten Frames. Dies wird wahrscheinlich von der Gesamtheit der tatsächlichen Frame-Größen abweichen.

totalEncodeTime

Ein Gleitkommawert, der die Gesamtanzahl der Sekunden angibt, die mit der Kodierung der bisher von diesem RTCRtpSender kodierten Frames verbracht wurden.

trackId

Die id des RTCSenderAudioTrackAttachmentStats oder RTCSenderVideoTrackAttachmentStats-Objekts, das die aktuelle Spurbindung an den RTCRtpSender enthält, der für diesen Stream verantwortlich ist.

Allgemeine Instanz-Eigenschaften

Die folgenden Eigenschaften sind allen WebRTC-Statistik-Objekten gemeinsam.

id

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

timestamp

Ein DOMHighResTimeStamp-Objekt, das den Zeitpunkt angibt, zu dem die Stichprobe für dieses Statistik-Objekt genommen wurde.

type

Ein String mit dem Wert "outbound-rtp", der 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