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 entferntenRTCRtpReceiver
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 entferntenRTCRtpReceiver
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
oderother
, 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 vongetStats()
. 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
desRTCAudioSenderStats
- oderRTCVideoSenderStats
-Objekts, das Statistiken über diesen Stream'sRTCRtpSender
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
desRTCSenderAudioTrackAttachmentStats
oderRTCSenderVideoTrackAttachmentStats
-Objekts, das die aktuelle Spurbindung an denRTCRtpSender
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