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.

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 gewonnen werden, indem Sie den RTCStatsReport durchlaufen, der von RTCPeerConnection.getStats() oder RTCRtpReceiver.getStats() zurückgegeben wird, 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-Ganzzahlwert, der die Gesamtanzahl der bisher für diese Medienquelle empfangenen Bytes angibt.

fecPacketsDiscarded

Ein Ganzzahlwert, der die Anzahl der RTP-Pakete zur Vorwärtsfehlerkorrektur (FEC) angibt, die für diese Quelle empfangen wurden, deren Fehlerkorrektur-Nutzlast jedoch verworfen wurde.

fecPacketsReceived

Ein Ganzzahlwert, der die Gesamtanzahl der für diese Quelle empfangenen RTP-FEC-Pakete angibt. Dieser Zähler kann auch erhöht werden, wenn FEC-Pakete gemeinsam mit Medieninhalten im Band ankommen; dies kann beispielsweise bei Opus passieren.

framesDecoded

Ein Wert vom Typ long, der die Gesamtanzahl der bisher für diese Medienquelle korrekt decodierten Videoframes angibt. Dies ist die Anzahl der Frames, die gerendert worden wären, wenn keine verworfen wurden. Nur gültig für Videostreams.

lastPacketReceivedTimestamp

Ein DOMHighResTimeStamp, der den Zeitpunkt angibt, zu dem das letzte Paket für diese Quelle empfangen wurde. Die timestamp-Eigenschaft hingegen gibt den Zeitpunkt an, zu dem das Statistikobjekt erstellt wurde.

nackCount

Ein Ganzzahlwert, der die Gesamtanzahl der negativen Bestätigungs-(NACK)-Pakete angibt, die dieser Empfänger gesendet hat.

packetsDuplicated

Ein Ganzzahlwert, der die Gesamtanzahl der Pakete angibt, die verworfen wurden, weil sie Duplikate waren. Diese Pakete werden nicht durch packetsDiscarded gezählt.

packetsFailedDecryption

Eine Ganzzahl, die die Anzahl der RTP-Pakete summiert, die nicht entschlüsselt werden konnten. Diese Pakete werden nicht durch packetsDiscarded gezählt.

perDscpPacketsReceived

Ein Datensatz aus Schlüssel-Wert-Paaren mit Zeichenfolgen als Schlüsseln, die auf 32-Bit-Ganzzahlen abgebildet sind. Jede Angabe steht für die Gesamtanzahl der Pakete, die dieser Empfänger in diesem RTP-Stream von dieser Quelle für jeden Differentiated Services Code Point (DSCP) erhalten hat.

receiverId

Eine Zeichenfolge, die das RTCAudioReceiverStats- oder RTCVideoReceiverStats-Objekt identifiziert, das dem Empfänger des Streams zugeordnet ist. Diese ID ist stabil über mehrere Aufrufe von getStats().

remoteId

Eine Zeichenfolge, die das RTCRemoteOutboundRtpStreamStats-Objekt identifiziert, das Statistiken für den entfernten Peer für diese gleiche SSRC bereitstellt. Diese ID ist stabil über mehrere Aufrufe von getStats().

sliCount

Eine Ganzzahl, die angibt, wie oft der Empfänger einen Slice Loss Indication (SLI)-Frame an den Sender gesendet hat, um ihm mitzuteilen, dass ein oder mehrere aufeinanderfolgende (in Bezug auf die Scanreihenfolge) Videomakroblöcke verlorengegangen oder beschädigt sind. Nur für Videostreams verfügbar.

trackIdentifier

Eine Zeichenfolge, die den id-Wert des MediaStreamTrack enthält, der mit dem eingehenden Stream verbunden ist.

trackId Veraltet

Eine Zeichenfolge, die das Statistikobjekt identifiziert, das den Empfangstrack darstellt; dieses Objekt ist eine von zwei Arten: RTCReceiverAudioTrackAttachmentStats oder RTCReceiverVideoTrackAttachmentStats. Diese ID ist stabil über mehrere Aufrufe von getStats().

Statistiken, die am Empfänger eines RTP-Streams gemessen werden

Diese Statistiken werden am empfangenden Ende eines RTP-Streams gemessen, unabhängig davon, ob es lokal oder entfernt ist.

packetsReceived

Die Gesamtanzahl der für diese synchronisierende Quelle empfangenen RTP-Pakete, einschließlich Retransmissionen.

packetsLost

Die Gesamtanzahl der für diese synchronisierende Quelle verlorenen RTP-Pakete. 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 verfügbare Messungen

Diese Eigenschaften werden lokal berechnet und sind nur auf dem Gerät verfügbar, das den Medienstrom empfängt. Ihr Hauptzweck ist die Untersuchung der Fehlerresilienz der Verbindung, da sie Informationen über verlorene Pakete, verlorene Frames und die Kompressionsstärke der Daten liefern.

nackCount

Die Anzahl der Male, die der Empfänger den Sender benachrichtigt hat, dass ein oder mehrere RTP-Pakete verloren gegangen sind, indem er ein Negativ-Acknowledgement-(NACK, auch "Generic NACK" genannt)-Paket an den Sender 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 von diesem RTP-Empfänger bis heute decodierte Frame auf der Videospur enthält, die durch dieses Statistikobjekt beschrieben wird. Sie können den durchschnittlichen QP pro Frame annähernd berechnen, indem Sie diesen Wert durch framesDecoded teilen, wobei Sie berücksichtigen müssen, dass Codecs oft die Quantisiererwerte sogar innerhalb von Frames variieren. Beachten Sie auch, dass die QP-Werte von Codec zu Codec variieren können, sodass dieser Wert nur potenziell nützlich ist, wenn er mit demselben Codec verglichen wird. Nur gültig für Videostreams.

Gemeinsame RTP-Stream-Statistiken

codecId

Eine Zeichenfolge, die das Objekt eindeutig identifiziert, welches inspiziert wurde, um das RTCCodecStats-Objekt zu erstellen, das mit diesem RTP-Stream verbunden ist.

kind

Eine Zeichenfolge, die angibt, ob der mit dem Stream verbundene MediaStreamTrack eine Audio- oder eine Videospur ist.

ssrc

Die 32-Bit-Ganzzahl, die die Quelle der RTP-Pakete identifiziert, die dieses Objekt bereitstellt. Dieser Wert wird gemäß der RFC 3550-Spezifikation generiert.

transportId

Eine Zeichenfolge, die das Objekt eindeutig identifiziert, welches inspiziert wurde, um das RTCTransportStats-Objekt zu erstellen, das mit diesem RTP-Stream verbunden ist.

Gemeinsame Instanz-Eigenschaften

Die folgenden Eigenschaften sind allen WebRTC-Statistikobjekten gemeinsam.

id

Eine Zeichenfolge, die das Objekt, das überwacht wird, um diesen Satz von Statistiken zu erstellen, eindeutig identifiziert.

timestamp

Ein DOMHighResTimeStamp-Objekt, das den Zeitpunkt angibt, zu dem die Probe für dieses Statistikobjekt entnommen wurde.

type

Eine Zeichenfolge mit dem Wert "inbound-rtp", die 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