RTCOutboundRtpStreamStats
Baseline
Weitgehend verfügbar
*
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Februar 2020 browserübergreifend verfügbar.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
Das RTCOutboundRtpStreamStats-Dictionary der WebRTC API wird verwendet, um Metriken und Statistiken zu einem ausgehenden RTP-Stream bereitzustellen, der von einem RTCRtpSender gesendet wird.
Die Statistiken können abgerufen werden, indem Sie den von RTCPeerConnection.getStats() oder RTCRtpSender.getStats() zurückgegebenen RTCStatsReport durchlaufen, bis Sie einen Bericht finden, dessen type outbound-rtp ist.
Instanzeigenschaften
active-
Ein boolescher Wert, der angibt, ob dieser RTP-Stream für das Senden konfiguriert oder deaktiviert ist.
frameHeight-
Eine Ganzzahl, die die Höhe des zuletzt codierten Frames in Pixeln angibt. Für Audiostreams nicht definiert.
frameWidth-
Eine Ganzzahl, die die Breite des zuletzt codierten Frames in Pixeln angibt. Für Audiostreams nicht definiert.
framesEncoded-
Die Anzahl der Frames, die bisher erfolgreich für das Senden über diesen RTP-Stream codiert wurden. Für Audiostreams nicht definiert.
framesPerSecond-
Eine Zahl, die angibt, wie viele codierte Frames in der letzten Sekunde gesendet wurden. Für Audiostreams nicht definiert.
framesSent-
Eine positive Ganzzahl, die die Gesamtzahl der über diesen RTP-Stream gesendeten codierten Frames angibt. Für Audiostreams nicht definiert.
headerBytesSent-
Eine positive Ganzzahl, die die Gesamtzahl der für diese SSRC gesendeten Bytes für RTP-Header und Padding angibt.
keyFramesEncoded-
Eine positive Ganzzahl, die die Gesamtzahl der in diesem RTP-Medienstream erfolgreich codierten Keyframes angibt. Für Audiostreams nicht definiert.
mediaSourceId-
Ein String, der die ID des Statistikobjekts des Tracks angibt, der derzeit mit dem Sender dieses Streams verbunden ist.
mid-
Ein String, der die Zuordnung von Quelle und Ziel des Streams des Transceivers eindeutig identifiziert. Dies ist der Wert der zugehörigen
RTCRtpTransceiver.mid, sofern dieser nicht null ist. Andernfalls ist die Statistikeigenschaft nicht vorhanden. nackCount-
Eine Ganzzahl, die die Gesamtzahl der Negative-ACKnowledgement-Pakete (NACK) angibt, die dieser
RTCRtpSendervom entferntenRTCRtpReceiverempfangen hat. Dieser lokal berechnete Wert gibt einen Hinweis auf die Fehlertoleranz der Verbindung. qpSum-
Ein 64-Bit-Wert, der die Summe der QP-Werte für jeden von diesem
RTCRtpSendercodierten Frame enthält. Dieser lokal berechnete Wert gibt einen Hinweis darauf, wie stark die Daten komprimiert sind. Für Audiostreams nicht definiert. qualityLimitationDurations-
Eine Zuordnung der Gründe, aus denen die Auflösung oder Bildrate eines Medienstreams reduziert wurde, zu der jeweiligen Dauer der Qualitätseinschränkung. Für Audiostreams nicht definiert.
qualityLimitationReason-
Ein String, der den Grund angibt, weshalb die Qualität des Streams eingeschränkt wird. Einer der Werte
none,cpu,bandwidthoderother. Für Audiostreams nicht definiert. remoteId-
Ein String, der das
RTCRemoteInboundRtpStreamStats-Objekt identifiziert, das Statistiken für den entfernten Peer zu derselben SSRC bereitstellt. Diese ID bleibt über mehrere Aufrufe vongetStats()hinweg gleich. retransmittedBytesSent-
Eine positive Ganzzahl, die die Gesamtzahl der erneut übertragenen Nutzdatenbytes für die diesem Stream zugeordnete Quelle angibt.
retransmittedPacketsSent-
Eine positive Ganzzahl, die die Gesamtzahl der erneut übertragenen Pakete für die diesem Stream zugeordnete Quelle angibt.
rid-
Ein String, der die RTP-Stream-ID für einen zugehörigen Videostream angibt.
scalabilityMode-
Ein String, der den Skalierbarkeitsmodus des RTP-Streams angibt, sofern einer konfiguriert wurde.
targetBitrate-
Eine Zahl, die die Bitrate angibt, die der Codec des
RTCRtpSenderderzeit für den Stream zu erreichen versucht. totalEncodeTime-
Eine Zahl, die die Gesamtzeit in Sekunden angibt, die für die Codierung der von diesem
RTCRtpSenderfür den Stream codierten Frames aufgewendet wurde. Für Audiostreams nicht definiert. totalEncodedBytesTarget-
Die kumulierte Summe der angestrebten Framegrößen aller bisher codierten Frames. Sie unterscheidet sich wahrscheinlich von der Summe der tatsächlichen Framegrößen. Für Audiostreams nicht definiert.
totalPacketSendDelay-
Eine Zahl, die die Gesamtzeit in Sekunden angibt, während der Pakete vor der Übertragung lokal zwischengespeichert waren.
Statistiken für gesendete RTP-Streams
bytesSentOptional-
Eine positive Ganzzahl, die die Gesamtzahl der für diese SSRC gesendeten Bytes einschließlich erneuter Übertragungen angibt.
packetsSentOptional-
Eine positive Ganzzahl, die die Gesamtzahl der für diese SSRC gesendeten RTP-Pakete einschließlich erneuter Übertragungen angibt.
Allgemeine RTP-Stream-Statistiken
codecIdOptional-
Ein String, der das Objekt eindeutig identifiziert, dessen Untersuchung das diesem RTP-Stream zugeordnete
RTCCodecStats-Objekt ergeben hat. kind-
Ein String, der angibt, ob der dem Stream zugeordnete
MediaStreamTrackein Audio- oder Videotrack ist. ssrc-
Eine positive Ganzzahl, die die SSRC der RTP-Pakete in diesem Stream identifiziert.
transportIdOptional-
Ein String, der das Objekt eindeutig identifiziert, dessen Untersuchung das diesem RTP-Stream zugeordnete
RTCTransportStats-Objekt ergeben hat.
Allgemeine Instanzeigenschaften
Die folgenden Eigenschaften sind allen WebRTC-Statistikobjekten gemeinsam.
id-
Ein String, der das überwachte Objekt, für das diese Statistiken erstellt werden, eindeutig identifiziert.
timestamp-
Ein
DOMHighResTimeStamp-Objekt, das den Zeitpunkt angibt, zu dem die Messung für dieses Statistikobjekt erfolgte. type-
Ein String mit dem Wert
"outbound-rtp", der den Typ der im Objekt enthaltenen Statistiken angibt.
Spezifikationen
| Spezifikation |
|---|
| Identifiers for WebRTC's Statistics API # dom-rtcstatstype-outbound-rtp |