RTCInboundRtpStreamStats
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Januar 2020.
{"* "}Some parts of this feature may have varying levels of support.
Das RTCInboundRtpStreamStats
Wörterbuch der WebRTC API wird verwendet, um Statistiken zu melden, die sich auf das Empfangsende eines RTP-Streams am lokalen Ende der RTCPeerConnection
beziehen.
Die Statistiken können durch Iteration des RTCStatsReport
erhalten werden, der von RTCPeerConnection.getStats()
oder RTCRtpReceiver.getStats()
zurückgegeben wird, bis Sie einen Bericht mit dem type
von inbound-rtp
finden.
Instanzeigenschaften
audioLevel
-
Eine Zahl, die den Audiopegel der empfangenen Spur angibt. Nicht definiert für Videostreams.
bytesReceived
-
Eine positive Ganzzahl, die die Gesamtzahl der bisher für diese Medienquelle empfangenen Bytes anzeigt.
concealedSamples
-
Eine positive Ganzzahl, die die Anzahl der verdeckten Samples angibt, da sie sich in Paketen befanden, die verloren gingen oder zu spät ankamen, um abgespielt zu werden. Nicht definiert für Videostreams.
concealmentEvents
-
Eine positive Ganzzahl, die die Anzahl der Verschleierungsereignisse angibt, bei denen ein einzelnes Ereignis für alle aufeinanderfolgenden verdeckten Samples nach einem nicht verdeckten Sample gezählt wird. Nicht definiert für Videostreams.
estimatedPlayoutTimestamp
Experimentell-
Ein
DOMHighResTimeStamp
, der die geschätzte Wiedergabezeit des Tracks dieses Empfängers angibt. fecPacketsDiscarded
-
Ein positiver ganzzahliger Wert, der die Anzahl der empfangenen RTP-Forward-Error-Correction-(FEC)-Pakete für diese Quelle angibt, bei denen die Fehlerkorrektur-Payload verworfen wurde.
fecPacketsReceived
-
Ein positiver ganzzahliger Wert, der die Gesamtzahl der empfangenen Forward-Error-Correction-(FEC)-Pakete für diese Quelle angibt.
frameHeight
-
Eine positive Ganzzahl, die die Höhe des letzten decodierten Frames in Pixeln angibt. Nicht definiert für Audiostreams und vor der Dekodierung des ersten Frames.
framesAssembledFromMultiplePackets
Experimentell-
Eine positive Ganzzahl, die die Gesamtzahl der korrekt decodierten Frames für diesen RTP-Stream angibt, die aus mehr als einem RTP-Paket bestehen. Nicht definiert für Audiostreams.
framesDecoded
-
Ein langer ganzzahliger Wert, der die Gesamtanzahl der Videoframes angibt, die bis jetzt für diese Medienquelle korrekt decodiert wurden. Dies ist die Anzahl der Frames, die gerendert worden wären, wenn keine verloren gegangen wären. Nicht definiert für Audiostreams.
framesPerSecond
-
Eine positive Ganzzahl, die die Anzahl der in der letzten Sekunde decodierten Frames angibt. Nicht definiert für Audiostreams.
framesReceived
-
Eine positive Ganzzahl, die die Gesamtanzahl der vollständigen Frames angibt, die auf diesem RTP-Stream empfangen wurden. Nicht definiert für Audiostreams.
frameWidth
-
Eine positive Ganzzahl, die die Breite des letzten decodierten Frames in Pixeln angibt. Nicht definiert für Audiostreams und vor der Dekodierung des ersten Frames.
freezeCount
Experimentell-
Eine positive Ganzzahl, die die Gesamtanzahl der Videounterbrechungen angibt, die dieser Empfänger erfahren hat. Nicht definiert für Audiostreams.
headerBytesReceived
-
Eine positive Ganzzahl, die die Gesamtanzahl der empfangenen RTP-Header- und Auffüllbytes für diese SSRC angibt, einschließlich Übertragungen.
insertedSamplesForDeceleration
-
Eine positive Ganzzahl, die die Anzahl der hinzugefügten Samples angibt, um die Wiedergabe aus dem Jitter-Puffer zu verlangsamen. Nicht definiert für Videostreams.
jitterBufferDelay
-
Eine Zahl, die die akkumulierte Zeit angibt, die alle Audiosamples und vollständige Videoframes im Jitter-Puffer verbracht haben, in Sekunden.
jitterBufferEmittedCount
-
Eine positive Ganzzahl, die die Gesamtzahl der Audiosamples und/oder Videoframes angibt, die aus dem Jitter-Puffer herausgekommen sind.
jitterBufferMinimumDelay
-
Eine Zahl, die die minimale Verzögerung angibt, die nur basierend auf den Netzwerkeigenschaften wie Jitter und Paketverlust erreicht werden könnte.
jitterBufferTargetDelay
-
Eine Zahl, die die akkumulierte Ziel-Jitter-Puffer-Verzögerung angibt.
keyFramesDecoded
-
Eine positive Ganzzahl, die die Gesamtanzahl der erfolgreich decodierten Keyframes für diesen RTP-Medienstream angibt. Nicht definiert für Audiostreams.
lastPacketReceivedTimestamp
-
Ein
DOMHighResTimeStamp
, der die Zeit angibt, zu der das letzte Paket für diese Quelle empfangen wurde. Dietimestamp
Eigenschaft hingegen gibt die Zeit an, zu der das Statistikobjekt erstellt wurde. mid
-
Eine Zeichenkette, die die Paarung von Quelle und Ziel des Streams des Transceivers eindeutig identifiziert. Dies ist der Wert der entsprechenden
RTCRtpTransceiver.mid
, es sei denn, dieser ist null, in diesem Fall ist die Statistik-Eigenschaft nicht vorhanden. packetsDiscarded
-
Eine positive Ganzzahl, die die Gesamtanzahl der RTP-Pakete angibt, die aufgrund von später oder zu früh erfolgter Ankunft durch den Jitter-Puffer verworfen wurden.
pauseCount
Experimentell-
Eine positive Ganzzahl, die die Anzahl der Video-Pausen angibt, die dieser Empfänger erlebt hat. Nicht definiert für Audiostreams.
playoutId
Experimentell-
Eine Zeichenkette, die die entsprechende
RTCAudioPlayoutStats
für einen Audiostream identifiziert. Nicht definiert für Videostreams. remoteId
-
Eine Zeichenkette, die das
RTCRemoteOutboundRtpStreamStats
Objekt identifiziert, das Statistiken für den entfernten Peer für diese gleiche SSRC bereitstellt. Diese ID ist über mehrere Aufrufe vongetStats()
hinweg stabil. removedSamplesForAcceleration
-
Eine positive Ganzzahl, die die Anzahl der entfernten Samples angibt, um die Wiedergabe aus dem Jitter-Puffer zu beschleunigen. Nicht definiert für Videostreams.
silentConcealedSamples
-
Eine positive Ganzzahl, die die Anzahl der stummgeschalteten, verdeckten Samples angibt. Nicht definiert für Videostreams.
totalAssemblyTime
Experimentell-
Eine Zahl, die die gesamte Zeit angibt, die zum Zusammenstellen von erfolgreich decodierten Videoframes benötigt wurde, die in mehreren RTP-Paketen transportiert wurden, in Sekunden. Nicht definiert für Audiostreams.
totalAudioEnergy
-
Eine Zahl, die die gesamte Audioenergie der empfangenen Spur über die Lebensdauer des Statistikobjekts darstellt. Nicht definiert für Videostreams.
totalDecodeTime
-
Eine Zahl, die die gesamte Zeit angibt, die zum Decodieren von Frames in diesem Stream benötigt wurde, in Sekunden. Nicht definiert für Audiostreams.
totalFreezesDuration
Experimentell-
Eine positive Zahl, die die gesamte Zeit angibt, die der Stream eingefroren war, in Sekunden. Nicht definiert für Audiostreams.
totalInterFrameDelay
-
Eine positive Zahl, die die gesamte Zeit angibt, die zwischen aufeinanderfolgend gerenderten Frames verbracht wurde, unmittelbar nachdem ein Frame gerendert wurde. Nicht definiert für Audiostreams.
totalPausesDuration
Experimentell-
Eine positive Zahl, die die gesamte Zeit angibt, die der Stream mit pausiertem Video verbracht hat, in Sekunden. Nicht definiert für Audiostreams.
totalProcessingDelay
-
Eine positive Zahl, die die gesamte Zeit angibt, die mit der Verarbeitung von Audio- oder Videosamples verbracht wurde, in Sekunden.
totalSamplesDuration
-
Eine positive Zahl, die die Gesamtdauer aller empfangenen Samples in Sekunden angibt. Nicht definiert für Videostreams.
totalSamplesReceived
-
Eine positive Ganzzahl, die die Gesamtanzahl der auf diesem Stream empfangenen Samples angibt. Nicht definiert für Videostreams.
totalSquaredInterFrameDelay
-
Eine positive Zahl, die die Summe der Quadrate der Inter-Frame-Verzögerungen zwischen aufeinanderfolgend gerenderten Frames angibt, unmittelbar nachdem ein Frame gerendert wurde. Nicht definiert für Audiostreams.
trackIdentifier
-
Eine Zeichenkette, die den
id
Wert desMediaStreamTrack
bereitstellt, der mit dem einkommenden Stream verbunden ist.
Nur lokal gemessene Werte
Diese Eigenschaften werden lokal berechnet und sind nur für das Gerät verfügbar, das den Medienstream empfängt. Ihr Hauptzweck ist die Untersuchung der Fehlerresistenz der Verbindung, da sie Informationen zu verlorenen Paketen, verlorenen Frames und zur Kompression der Daten bereitstellen.
nackCount
-
Eine Zahl, die angibt, wie oft der Empfänger den Sender benachrichtigt hat, dass ein oder mehrere RTP-Pakete verloren gegangen sind, indem ein Negative ACKnowledgement (NACK, auch "Generic NACK" genannt) Paket an den Sender gesendet wurde. Dieser Wert ist nur für den Empfänger verfügbar.
qpSum
-
Eine positive Ganzzahl, die die Summe der QP-Werte für jedes bisher von diesem RTP-Empfänger decodierte Frame auf der durch dieses Statistikobjekt beschriebenen Videospur bereitstellt. Nur gültig für Videostreams.
Statistiken, die beim Empfänger eines RTP-Streams gemessen werden
Diese Statistiken werden am Empfangsende eines RTP-Streams gemessen, unabhängig davon, ob es sich um ein lokales oder entferntes Ende handelt.
packetsReceived
-
Die Gesamtanzahl der empfangenen RTP-Pakete für diese synchronisierende Quelle (SSRC), einschließlich Übertragungen.
packetsLost
-
Die Gesamtanzahl der verlorenen RTP-Pakete für diese synchronisierende Quelle (SSRC). Beachten Sie, dass dies negativ sein kann, da mehr Pakete empfangen werden können, als der Empfänger erwartet.
jitter
-
Paketjitter für diese synchronisierende Quelle (SSRC), gemessen in Sekunden.
Gemeinsame RTP-Stream-Statistiken
codecId
-
Eine Zeichenkette, die das Objekt eindeutig identifiziert, das überprüft wurde, um das
RTCCodecStats
Objekt zu erstellen, das mit diesem RTP Stream verbunden ist. kind
-
Eine Zeichenkette, die angibt, ob der mit dem Stream verbundene
MediaStreamTrack
ein Audio- oder Videotrack ist. ssrc
-
Die 32-Bit-Ganzzahl, die die Quelle der RTP-Pakete identifiziert, die dieses Objekt bereitstellt. Dieser Wert wird gemäß der RFC 3550 Spezifikation generiert.
transportId
-
Eine Zeichenkette, die das Objekt eindeutig identifiziert, das überprüft wurde, um das
RTCTransportStats
Objekt zu erstellen, das mit diesem RTP-Stream verbunden ist.
Allgemeine Instanzeigenschaften
Die folgenden Eigenschaften sind allen WebRTC-Statistikobjekten gemeinsam.
id
-
Eine Zeichenkette, die das Objekt eindeutig identifiziert, das überwacht wird, um diesen Satz von Statistiken zu erstellen.
timestamp
-
Ein
DOMHighResTimeStamp
Objekt, das den Zeitpunkt angibt, zu dem die Probe für dieses Statistikobjekt genommen wurde. type
-
Eine Zeichenkette mit dem Wert
"inbound-rtp"
, die angibt, welche Art von Statistiken das Objekt enthält.
Spezifikationen
Specification |
---|
Identifiers for WebRTC's Statistics API> # dom-rtcstatstype-inbound-rtp> |
Browser-Kompatibilität
Loading…