RTCRtpStreamStats
Das RTCRtpStreamStats
-Wörterbuch wird von den Methoden RTCPeerConnection.getStats()
, RTCRtpSender.getStats()
und RTCRtpReceiver.getStats()
zurückgegeben, um detaillierte Statistiken über die WebRTC-Konnektivität bereitzustellen.
Während das Wörterbuch eine Basisstruktur von Eigenschaften besitzt, die in jedem dieser Fälle vorhanden sind, werden je nach Schnittstelle, auf die die Methode aufgerufen wird, zusätzliche Eigenschaften hinzugefügt.
RTCRtpStreamStats
ist die Basisklasse für alle RTP-bezogenen Statistikberichte.
Hinweis:
Diese Schnittstelle hieß bis zu einem Spezifikationsupdate im Frühjahr 2017 RTCRTPStreamStats
.
Überprüfen Sie die Browser-Kompatibilität-Tabelle, um zu erfahren, ob und wann die Namensänderung in bestimmten Browsern implementiert wurde.
Instanz-Eigenschaften
Standardfelder, die für alle Medientypen enthalten sind
codecId
-
Ein String, der das Objekt eindeutig identifiziert, welches inspiziert wurde, um das
RTCCodecStats
-Objekt zu erzeugen, das mit diesem RTP-Stream verknüpft ist. kind
-
Ein String, dessen Wert
"audio"
ist, wenn der zugehörigeMediaStreamTrack
nur Audio enthält, oder"video"
, wenn der Track Video enthält. Dieser Wert stimmt mit dem Medientyp überein, der durchRTCCodecStats.codec
sowie mit derkind
-Eigenschaft des Tracks angezeigt wird. Früher wurde diesmediaType
genannt. ssrc
-
Die 32-Bit-Zahl, die die Quelle der RTP-Pakete identifiziert, die dieses
RTCRtpStreamStats
-Objekt abdeckt. Dieser Wert wird gemäß der RFC 3550-Spezifikation generiert. trackId
-
Ein String, der das
RTCMediaStreamTrackStats
-Objekt, das den zugehörigenMediaStreamTrack
darstellt, eindeutig identifiziert. Dies ist nicht dasselbe wie der Wert vonMediaStreamTrack.id
. transportId
-
Ein String, der das Objekt eindeutig identifiziert, welches inspiziert wurde, um das
RTCTransportStats
-Objekt zu erzeugen, das mit diesem RTP-Stream verknüpft ist.
Gemeinsame Instanz-Eigenschaften
Die folgenden Eigenschaften sind allen WebRTC-Statistikobjekten gemeinsam.
- `id
-
Ein String, der das Objekt eindeutig identifiziert, das überwacht wird, um diese Statistikmenge zu erzeugen.
timestamp
-
Ein
DOMHighResTimeStamp
-Objekt, das den Zeitpunkt angibt, zu dem die Stichprobe für dieses Statistikobjekt entnommen wurde. type
-
Ein String, der den Typ der Statistiken angibt, die das Objekt enthält.
Nur lokal gemessene Daten
Diese Eigenschaften werden lokal berechnet und sind nur für das Gerät verfügbar, das den Medienstream empfängt. Ihr Hauptzweck ist es, die Fehlerbeständigkeit der Verbindung zu untersuchen, da sie Informationen über verlorene Pakete, verlorene Frames und den Kompressionsgrad der Daten liefern.
firCount
-
Eine Zählung der Gesamtzahl von Full Intra Request (FIR)-Paketen, die vom Sender empfangen wurden. Diese Statistik ist nur für das Gerät verfügbar, das den Stream empfängt und nur für Videotracks verfügbar. Ein FIR-Paket wird vom empfangenden Ende des Streams gesendet, wenn es in Rückstand gerät oder Pakete verloren hat und den Stream nicht mehr dekodieren kann; das sendende Ende des Streams empfängt das FIR-Paket und reagiert, indem es einen vollständigen Frame anstelle eines Delta-Frames sendet, wodurch der Empfänger wieder "aufholen" kann. Je höher diese Zahl ist, desto öfter trat ein Problem dieser Art auf, was ein Zeichen für Netzwerküberlastung oder ein überlastetes Empfangsgerät sein kann.
nackCount
-
Die Anzahl der Male, die der Empfänger den Sender darüber informiert hat, dass ein oder mehrere RTP-Pakete durch das Senden eines Negative ACKnowledgement (NACK, auch "Generic NACK" genannt) Pakets an den Sender verloren gegangen sind. Dieser Wert ist nur für den Empfänger verfügbar.
pliCount
-
Die Anzahl der Male, die das empfangende Ende des Streams ein Picture Loss Indication (PLI)-Paket an den Sender gesendet hat, das anzeigt, dass ein Teil der kodierten Videodaten für ein oder mehrere Frames verloren gegangen ist. Nur der Empfänger hat diesen Wert, und er ist nur für Videotracks gültig.
qpSum
-
Die Summe der Quantisierungsparameter (QP)-Werte, die jedem bisher empfangenen Frame auf dem von diesem
RTCRtpStreamStats
-Objekt beschriebenen Videotrack zugeordnet sind. Im Allgemeinen gilt: Je höher diese Zahl ist, desto stärker komprimiert war der Videotrack. Kombiniert mitRTCReceivedRtpStreamStats.framesDecoded
oderRTCSentRtpStreamStats.framesEncoded
können Sie den durchschnittlichen QP über diese Frames abschätzen, wobei zu beachten ist, dass Codecs oft auch innerhalb einzelner Frames die Quantisierungswerte variieren. Außerdem ist zu bedenken, dass die QP-Werte von Codec zu Codec variieren können, weshalb dieser Wert nur dann von potenziellem Nutzen ist, wenn er gegen denselben Codec verglichen wird.
Spezifikationen
No specification found
No specification data found for api.RTCRtpStreamStats
.
Check for problems with this page or contribute a missing spec_url
to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.
Browser-Kompatibilität
BCD tables only load in the browser