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 zu einem ausgehenden RTP-Stream zu melden, der von einem RTCRtpSender
gesendet wird.
Die Statistiken können durch Iteration über den RTCStatsReport
erhalten werden, der von RTCPeerConnection.getStats()
oder RTCRtpSender.getStats()
zurückgegeben wird, bis Sie einen Bericht mit dem type
von outbound-rtp
finden.
Instanz-Eigenschaften
active
Experimentell-
Ein Boolean, der anzeigt, ob dieser RTP-Stream zum Senden konfiguriert ist oder deaktiviert ist.
frameHeight
-
Ein Ganzzahlwert, der die Höhe des letzten kodierten Frames in Pixeln angibt. Nicht definiert für Audiostreams.
frameWidth
-
Ein Ganzzahlwert, der die Breite des letzten kodierten Frames in Pixeln angibt. Nicht definiert für Audiostreams.
framesEncoded
-
Die Anzahl der Frames, die bisher erfolgreich zum Senden auf diesem RTP-Stream kodiert wurden. Nicht definiert für Audiostreams.
framesPerSecond
-
Eine Zahl, die die im letzten Sekundenintervall gesendeten kodierten Frames darstellt. Nicht definiert für Audiostreams.
framesSent
-
Eine positive Ganzzahl, die die Gesamtanzahl der auf diesem RTP-Stream gesendeten kodierten Frames darstellt. Nicht definiert für Audiostreams.
headerBytesSent
-
Eine positive Ganzzahl, die die Gesamtzahl der gesendeten RTP-Header- und Padding-Bytes für diesen SSRC darstellt.
keyFramesEncoded
Experimentell-
Eine positive Ganzzahl, die die Gesamtzahl der erfolgreich in diesem RTP-Medienstream kodierten Schlüsselbilder darstellt. Nicht definiert für Audiostreams.
mediaSourceId
-
Eine Zeichenfolge, die die ID des Statistikobjekts des Tracks darstellt, der derzeit am Sender dieses Streams angehängt ist.
mid
-
Eine Zeichenfolge, die das Paar aus Quelle und Ziel des Transceiver-Streams eindeutig identifiziert. Dies ist der Wert des entsprechenden
RTCRtpTransceiver.mid
, es sei denn, dieser ist null, in diesem Fall ist die Statistik-Eigenschaft nicht vorhanden. nackCount
-
Ein Ganzzahlwert, der die Gesamtanzahl der negativen Bestätigungspakete (NACK) angibt, die dieser
RTCRtpSender
vom entferntenRTCRtpReceiver
erhalten hat. Dieser lokal berechnete Wert gibt einen Hinweis auf die Fehlerfestigkeit der Verbindung. qpSum
-
Ein 64-Bit-Wert, der die Summe der QP-Werte für jeden von diesem
RTCRtpSender
kodierten Frame enthält. Dieser lokal berechnete Wert gibt einen Hinweis darauf, wie stark die Daten komprimiert sind. Nicht definiert für Audiostreams. qualityLimitationDurations
Experimentell-
Eine Zuordnung der Gründe, warum die Auflösung oder Bildrate eines Medienstreams reduziert wurde, und die Zeit, in der die Qualität aus jedem Grund reduziert wurde. Nicht definiert für Audiostreams.
qualityLimitationReason
Experimentell-
Eine Zeichenfolge, die den Grund angibt, warum der Stream qualitätsbegrenzt ist. Einer von:
none
,cpu
,bandwidth
oderother
. Nicht definiert für Audiostreams. remoteId
-
Eine Zeichenfolge, die das
RTCRemoteInboundRtpStreamStats
-Objekt identifiziert, das Statistiken für den entfernten Peer für diesen gleichen SSRC bereitstellt. Diese ID ist über mehrere Aufrufe vongetStats()
hinweg stabil. retransmittedBytesSent
-
Eine positive Ganzzahl, die die Gesamtzahl der erneut gesendeten Payload-Bytes für die Quelle darstellt, die mit diesem Stream verbunden ist.
retransmittedPacketsSent
-
Eine positive Ganzzahl, die die Gesamtanzahl der erneut gesendeten Pakete für die Quelle darstellt, die mit diesem Stream verbunden ist.
rid
-
Eine Zeichenfolge, die die RTP-Stream-ID für einen entsprechenden Videostream angibt.
scalabilityMode
Experimentell-
Eine Zeichenfolge, die 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 versucht, für den Stream zu erreichen. totalEncodeTime
-
Eine Zahl, die die Gesamtanzahl der Sekunden darstellt, die für das Kodieren der für diesen Stream kodierten Frames von
RTCRtpSender
aufgewendet wurden. Nicht definiert für Audiostreams. totalEncodedBytesTarget
Experimentell-
Eine kumulative Summe der geplanten Frame-Größen für alle bisher kodierten Frames. Dies wird wahrscheinlich von der Summe der tatsächlichen Frame-Größen abweichen. Nicht definiert für Audiostreams.
totalPacketSendDelay
-
Eine Zahl, die die gesamte Zeit in Sekunden darstellt, die Pakete lokal gepuffert verbracht haben, bevor sie gesendet wurden.
Statistiken über gesendete RTP-Streams
bytesSent
Optional-
Eine positive Ganzzahl, die die Gesamtanzahl der für diesen SSRC gesendeten Bytes angibt, einschließlich erneuter Sendungen.
packetsSent
Optional-
Eine positive Ganzzahl, die die Gesamtanzahl der für diesen SSRC gesendeten RTP-Pakete angibt, einschließlich erneuter Sendungen.
Gemeinsame RTP-Stream-Statistiken
codecId
Optional-
Eine Zeichenfolge, die das Objekt eindeutig identifiziert, das inspiziert wurde, um das
RTCCodecStats
-Objekt zu erzeugen, das mit diesem RTP-Stream verbunden ist. kind
-
Eine Zeichenfolge, die angibt, ob der mit dem Stream verbundene
MediaStreamTrack
ein Audio- oder Videotrack ist. ssrc
-
Eine positive Ganzzahl, die den SSRC der in diesem Stream enthaltenen RTP-Pakete identifiziert.
transportId
Optional-
Eine Zeichenfolge, die das Objekt eindeutig identifiziert, das inspiziert wurde, um das
RTCTransportStats
-Objekt zu erzeugen, das mit diesem RTP-Stream verbunden ist.
Gemeinsame Instanz-Eigenschaften
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 Uhrzeit 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.
Spezifikationen
Specification |
---|
Identifiers for WebRTC's Statistics API # dom-rtcstatstype-outbound-rtp |