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. Die timestamp-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- oder RTCVideoReceiverStats-Objekt, das mit dem Empfänger des Streams verbunden ist, identifiziert. Diese ID ist über mehrere Aufrufe von getStats() 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 von getStats() 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 des MediaStreamTrack 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 oder RTCReceiverVideoTrackAttachmentStats. Diese ID ist über mehrere Aufrufe von getStats() 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

Siehe auch