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

Browser-Kompatibilität

Siehe auch