RTCInboundRtpStreamStats
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 RTCInboundRtpStreamStats
-Dictionary der WebRTC API wird verwendet, um Statistiken im Zusammenhang mit dem Empfangsende eines RTP-Streams am lokalen Ende der RTCPeerConnection
zu berichten.
Die Statistiken können durch Iterieren des RTCStatsReport
erhalten werden, das von RTCPeerConnection.getStats()
oder RTCRtpReceiver.getStats()
zurückgegeben wird, bis Sie einen Bericht mit dem type
inbound-rtp
finden.
Instanzeigenschaften
averageRtcpInterval
-
Ein Gleitkommawert, der das durchschnittliche RTCP-Intervall zwischen zwei aufeinanderfolgenden zusammengesetzten RTCP-Paketen angibt.
bytesReceived
-
Ein 64-Bit-Integer, das die Gesamtzahl der Bytes angibt, die bisher für diese Medienquelle empfangen wurden.
fecPacketsDiscarded
-
Ein Integerwert, der die Anzahl der RTP-Forward Error Correction (FEC)-Pakete angibt, die für diese Quelle empfangen wurden und deren Fehlerkorrektur-Payload verworfen wurde.
fecPacketsReceived
-
Ein Integerwert, der die Gesamtzahl der für diese Quelle empfangenen RTP-FEC-Pakete angibt. Dieser Zähler kann auch erhöht werden, wenn FEC-Pakete zusammen mit Medieninhalten im Band ankommen; dies kann beispielsweise bei Opus der Fall sein.
framesDecoded
-
Ein langer Integerwert, der die Gesamtzahl der Videoframes angibt, die bisher für diese Medienquelle korrekt dekodiert wurden. Dies ist die Anzahl der Frames, die gerendert worden wären, wenn keine verworfen worden wären. Nur gültig für Videostreams.
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
-
Ein String, der das Paar aus Quelle und Ziel des Streams des Transceivers 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 Integerwert, der die Gesamtanzahl der Negative ACKnowledgement (NACK)-Pakete angibt, die dieser Empfänger gesendet hat.
packetsDuplicated
-
Ein Integerwert, der die Gesamtzahl der Pakete angibt, die verworfen wurden, weil sie Duplikate waren. Diese Pakete werden nicht von
packetsDiscarded
gezählt. packetsFailedDecryption
-
Eine Ganzzahl, die die Anzahl der RTP-Pakete angibt, die nicht entschlüsselt werden konnten. Diese Pakete werden nicht von
packetsDiscarded
gezählt. perDscpPacketsReceived
-
Ein Datensatz von Schlüssel-Wert-Paaren mit Strings als Schlüsseln, die auf 32-Bit-Integerwerte abgebildet sind, wobei jeder die Gesamtzahl der Pakete angibt, die dieser Empfänger auf diesem RTP-Stream von dieser Quelle für jeden Differentiated Services Code Point (DSCP) empfangen hat.
receiverId
-
Ein String, der das
RTCAudioReceiverStats
- oderRTCVideoReceiverStats
-Objekt identifiziert, das mit dem Empfänger des Streams verbunden ist. Diese ID bleibt bei mehreren Aufrufen vongetStats()
stabil. remoteId
-
Ein String, der das
RTCRemoteOutboundRtpStreamStats
-Objekt identifiziert, das Statistiken für den entfernten Peer für diesen selben SSRC liefert. Diese ID bleibt bei mehreren Aufrufen vongetStats()
stabil. sliCount
-
Ein Integerwert, der die Anzahl der Male angibt, zu denen der Empfänger einen Slice Loss Indication (SLI)-Frame an den Sender gesendet hat, um ihm mitzuteilen, dass ein oder mehrere aufeinanderfolgende (nach Scan-Reihenfolge) Videomakroblöcke verloren gegangen oder beschädigt sind. Nur für Videostreams verfügbar.
trackIdentifier
-
Ein String, der den
id
-Wert desMediaStreamTrack
enthält, das mit dem eingehenden Stream verbunden ist. trackId
Veraltet-
Ein String, der das Statistikobjekt identifiziert, das den empfangenden Track darstellt; dieses Objekt ist eine von zwei Typen:
RTCReceiverAudioTrackAttachmentStats
oderRTCReceiverVideoTrackAttachmentStats
. Diese ID bleibt bei mehreren Aufrufen vongetStats()
stabil.
Statistiken gemessen am Empfänger eines RTP-Streams
Diese Statistiken werden am Empfangsende eines RTP-Streams gemessen, unabhängig davon, ob es lokal oder entfernt ist.
packetsReceived
-
Die Gesamtzahl der RTP-Pakete, die für diese Synchronisationsquelle empfangen wurden, inklusive Übertragungen.
packetsLost
-
Die Gesamtzahl der für diese Synchronisationsquelle verlorenen RTP-Pakete. Beachten Sie, dass dieser Wert negativ sein kann, wenn mehr Pakete empfangen werden als gesendet.
jitter
-
Paket-Jitter für diese Synchronisationsquelle, gemessen in Sekunden.
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 es, die Fehlerresilienz der Verbindung zu überprüfen, da sie Informationen über verlorene Pakete, verlorene Frames und den Kompressionsgrad der Daten liefern.
nackCount
-
Die Anzahl der Male, zu denen der Empfänger den Absender per Negative ACKnowledgement (NACK, auch "Generic NACK" genannt) darüber informiert hat, dass ein oder mehrere RTP-Pakete verloren gegangen sind. Dieser Wert ist nur für den Empfänger verfügbar.
qpSum
-
Ein 64-Bit-Wert, der die Summe der QP-Werte für jedes von diesem RTP-Empfänger bisher dekodierte Frame auf der durch dieses Statistikobjekt beschriebenen Videospur enthält. Sie können den durchschnittlichen QP pro Frame annähern, indem Sie diesen Wert durch
framesDecoded
teilen, wobei Sie beachten sollten, dass Codecs die Quantisierungswerte oft auch innerhalb von Frames variieren. Beachten Sie auch, dass die Werte von QP je nach Codec variieren können, sodass dieser Wert nur potenziell nützlich ist, wenn er im Vergleich zu demselben Codec verwendet wird. Nur gültig für Videostreams.
Allgemeine RTP-Stream-Statistiken
codecId
-
Ein String, der das Objekt eindeutig identifiziert, das inspiziert wurde, um das
RTCCodecStats
-Objekt zu erzeugen, das mit diesem RTP-Stream verbunden ist. kind
-
Ein String, der angibt, ob der mit dem Stream verbundene
MediaStreamTrack
ein Audio- oder ein Videotrack ist. ssrc
-
Der 32-Bit-Integer, der die Quelle der RTP-Pakete identifiziert, die dieses Objekt bereitstellt. Dieser Wert wird gemäß der RFC 3550-Spezifikation generiert.
transportId
-
Ein String, der das Objekt eindeutig identifiziert, das inspiziert wurde, um das
RTCTransportStats
-Objekt zu erzeugen, das mit diesem RTP-Stream verbunden ist.
Allgemeine Instanzeigenschaften
Die folgenden Eigenschaften sind allen WebRTC-Statistikobjekten gemeinsam.
id
-
Ein String, der das Objekt eindeutig identifiziert, das überwacht wird, um diesen Satz von Statistiken zu erzeugen.
timestamp
-
Ein
DOMHighResTimeStamp
-Objekt, das die Zeit anzeigt, zu der die Probe für dieses Statistikobjekt entnommen wurde. type
-
Ein String mit dem Wert
"inbound-rtp"
, der den Typ der Statistiken angibt, die das Objekt enthält.
Spezifikationen
Specification |
---|
Identifiers for WebRTC's Statistics API # dom-rtcstatstype-inbound-rtp |