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. Dietimestamp
-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
- oderRTCVideoReceiverStats
-Objekt identifiziert, das dem Empfänger des Streams zugeordnet ist. Diese ID ist stabil über mehrere Aufrufe vongetStats()
. 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 vongetStats()
. 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 desMediaStreamTrack
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
oderRTCReceiverVideoTrackAttachmentStats
. Diese ID ist stabil über mehrere Aufrufe vongetStats()
.
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