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
Wörterbuch der WebRTC-API wird verwendet, um Statistiken im Zusammenhang mit dem empfangenden Ende eines RTP-Streams am lokalen Ende der RTCPeerConnection
zu berichten.
Die Statistiken können durch Iteration des RTCStatsReport
, das von RTCPeerConnection.getStats()
oder RTCRtpReceiver.getStats()
zurückgegeben wird, abgerufen werden, bis Sie einen Bericht mit dem type
inbound-rtp
finden.
Instanz-Eigenschaften
averageRtcpInterval
-
Ein Gleitkommawert, der das durchschnittliche RTCP-Intervall zwischen zwei aufeinanderfolgenden zusammengesetzten RTCP-Paketen angibt.
bytesReceived
-
Ein 64-Bit-Integer, der die Gesamtzahl der bislang für diese Medienquelle empfangenen Bytes angibt.
fecPacketsDiscarded
-
Ein Integer-Wert, der die Anzahl der RTP Forward Error Correction (FEC)-Pakete angibt, die für diese Quelle empfangen wurden, deren Fehlerkorrektur-Payload jedoch verworfen wurde.
fecPacketsReceived
-
Ein Integer-Wert, 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 in-band ankommen; dies kann beispielsweise bei Opus passieren.
framesDecoded
-
Ein langer Integer-Wert, der die Gesamtzahl der Videobilder angibt, die für diese Medienquelle bisher korrekt dekodiert wurden. Dies ist die Anzahl der Bilder, 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 den Zeitpunkt an, zu dem das Statistikobjekt erstellt wurde. mid
-
Ein String, der die Zuordnung 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 Statistikeigenschaft nicht vorhanden. nackCount
-
Ein Integer-Wert, der die gesamte Anzahl der Negativen ACKnowledgement (NACK)-Pakete angibt, die dieser Empfänger gesendet hat.
packetsDuplicated
-
Ein Integer-Wert, der die Gesamtzahl der Pakete angibt, die verworfen wurden, weil sie Duplikate waren. Diese Pakete werden nicht durch
packetsDiscarded
gezählt. packetsFailedDecryption
-
Ein Integer, der die Gesamtanzahl der RTP-Pakete angibt, die nicht entschlüsselt werden konnten. Diese Pakete werden nicht durch
packetsDiscarded
gezählt. perDscpPacketsReceived
-
Eine Aufzeichnung von Schlüssel-Wert-Paaren mit Strings als Schlüsseln, die auf 32-Bit-Integer-Werte abgebildet sind, von denen jeder die Gesamtanzahl der Pakete angibt, die dieser Empfänger auf diesem RTP-Stream von dieser Quelle für jeden Differentiated Services Code Point (DSCP) erhalten hat.
receiverId
-
Ein String, der das
RTCAudioReceiverStats
- oderRTCVideoReceiverStats
-Objekt, das mit dem Empfänger des Streams verbunden ist, identifiziert. Diese ID ist über mehrere Aufrufe vongetStats()
hinweg stabil. remoteId
-
Ein String, der das
RTCRemoteOutboundRtpStreamStats
-Objekt identifiziert, das Statistiken für das entfernte Gegenstück zu dieser gleichen SSRC bereitstellt. Diese ID ist über mehrere Aufrufe vongetStats()
hinweg stabil. sliCount
-
Ein Integer, der die Anzahl der Male angibt, denen der Empfänger einen Slice Loss Indication (SLI)-Frame an den Absender gesendet hat, um ihm mitzuteilen, dass eines oder mehrere aufeinanderfolgende (im Sinne der Scan-Reihenfolge) Video-Makroblöcke verloren gegangen oder beschädigt sind. Nur für Videostreams verfügbar.
trackIdentifier
-
Ein String, der den
id
-Wert desMediaStreamTrack
enthält, der 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 Arten:
RTCReceiverAudioTrackAttachmentStats
oderRTCReceiverVideoTrackAttachmentStats
. Diese ID ist über mehrere Aufrufe vongetStats()
hinweg stabil.
Messungen am Empfänger eines RTP-Streams
Diese Statistiken werden am empfangenden Ende eines RTP-Streams gemessen, unabhängig davon, ob es lokal oder entfernt ist.
packetsReceived
-
Die Gesamtanzahl der RTP-Pakete, die für diese synchronisierende Quelle empfangen wurden, einschließlich der erneuten Übertragungen.
packetsLost
-
Die Gesamtzahl der verlorenen RTP-Pakete für diese synchronisierende Quelle. Beachten Sie, dass dies negativ sein kann, wenn mehr Pakete empfangen als gesendet werden.
jitter
-
Paket-Jitter für diese synchronisierende Quelle, gemessen in Sekunden.
Nur lokal berechnete Messungen
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 Fehlerresistenz der Verbindung zu untersuchen, da sie Informationen über verlorene Pakete, verlorene Frames und die Komprimierungsrate der Daten bieten.
nackCount
-
Die Anzahl der Male, in denen der Empfänger den Absender benachrichtigt hat, dass eines oder mehrere RTP-Pakete verloren gegangen sind, indem er ein Negatives ACKnowledgement (NACK, auch als "Generic NACK" bezeichnet)-Paket an den Absender gesendet hat. 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 Bild enthält, das bisher von diesem RTP-Empfänger auf der durch dieses Statistikobjekt beschriebenen Videospur dekodiert wurde. Sie können den durchschnittlichen QP pro Frame abschätzen, 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 unterschiedlich sein können, sodass dieser Wert nur potenziell nützlich ist, wenn er gegen denselben Codec verglichen 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 erstellen, 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 erstellen, das mit diesem RTP-Stream verbunden ist.
Allgemeine Instanz-Eigenschaften
Die folgenden Eigenschaften sind für alle WebRTC-Statistikobjekte gemeinsam.
id
-
Ein String, der das Objekt, das überwacht wird, um diesen Satz von Statistiken zu erzeugen, eindeutig identifiziert.
timestamp
-
Ein
DOMHighResTimeStamp
-Objekt, das den Zeitpunkt angibt, zu dem die Stichprobe für dieses Statistikobjekt genommen wurde. type
-
Ein String mit dem Wert
"inbound-rtp"
, der den Typ der Statistiken angibt, die das Objekt enthält.
Beispiele
Spezifikationen
Specification |
---|
Identifiers for WebRTC's Statistics API # dom-rtcstatstype-inbound-rtp |
Browser-Kompatibilität
BCD tables only load in the browser