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.
Sie können die Statistiken abrufen, indem Sie den von RTCPeerConnection.getStats() oder RTCRtpSender.getStats() zurückgegebenen RTCStatsReport durchlaufen, bis Sie einen Bericht mit dem type outbound-rtp finden.
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 Audio-Streams nicht definiert.
frameWidth-
Eine Ganzzahl, die die Breite des zuletzt codierten Frames in Pixeln angibt. Für Audio-Streams nicht definiert.
framesEncoded-
Die Anzahl der Frames, die bisher erfolgreich für den Versand über diesen RTP-Stream codiert wurden. Für Audio-Streams nicht definiert.
framesPerSecond-
Eine Zahl, die angibt, wie viele codierte Frames in der letzten Sekunde gesendet wurden. Für Audio-Streams nicht definiert.
framesSent-
Eine positive Ganzzahl, die die Gesamtzahl der über diesen RTP-Stream gesendeten codierten Frames angibt. Für Audio-Streams nicht definiert.
headerBytesSent-
Eine positive Ganzzahl, die die Gesamtzahl der für diese SSRC gesendeten RTP-Header- und Padding-Bytes angibt.
keyFramesEncoded-
Eine positive Ganzzahl, die die Gesamtzahl der in diesem RTP-Medienstream erfolgreich codierten Keyframes angibt. Für Audio-Streams nicht definiert.
mediaSourceId-
Ein String, der die ID des Statistikobjekts des Tracks angibt, der derzeit dem Sender dieses Streams zugeordnet ist.
mid-
Ein String, der die Zuordnung zwischen Quelle und Ziel des Streams des Transceivers eindeutig identifiziert. Dies ist der Wert der entsprechenden
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 aller von diesem
RTCRtpSendercodierten Frames enthält. Dieser lokal berechnete Wert gibt einen Hinweis darauf, wie stark die Daten komprimiert sind. Für Audio-Streams nicht definiert. qualityLimitationDurations-
Eine Zuordnung der Gründe, aus denen die Auflösung oder Framerate eines Medienstreams reduziert wurde, zu der jeweiligen Dauer der Qualitätsminderung. Für Audio-Streams nicht definiert.
qualityLimitationReason-
Ein String, der den Grund angibt, aus dem die Qualität des Streams begrenzt wird. Einer der Werte
none,cpu,bandwidthoderother. Für Audio-Streams nicht definiert. remoteId-
Ein String, der das
RTCRemoteInboundRtpStreamStats-Objekt identifiziert, das Statistiken für die entfernte Gegenstelle zu derselben SSRC bereitstellt. Diese ID bleibt über mehrere Aufrufe vongetStats()hinweg gleich. retransmittedBytesSent-
Eine positive Ganzzahl, die die Gesamtzahl der erneut übertragenen Nutzdaten-Bytes 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 entsprechenden 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 gesamte Zeit in Sekunden angibt, die für die Codierung der von diesem
RTCRtpSenderfür den Stream codierten Frames aufgewendet wurde. Für Audio-Streams nicht definiert. totalEncodedBytesTarget-
Die kumulierte Summe der angestrebten Frame-Größen aller bisher codierten Frames. Sie wird sich wahrscheinlich von der Summe der tatsächlichen Frame-Größen unterscheiden. Für Audio-Streams nicht definiert.
totalPacketSendDelay-
Eine Zahl, die die gesamte Zeit in Sekunden angibt, die Pakete vor ihrer Übertragung im lokalen Puffer verbracht haben.
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 Statistiken zu RTP-Streams
codecIdOptional-
Ein String, der das Objekt eindeutig identifiziert, aus dem das diesem RTP-Stream zugeordnete
RTCCodecStats-Objekt erzeugt wurde. 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, aus dem das diesem RTP-Stream zugeordnete
RTCTransportStats-Objekt erzeugt wurde.
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 angibt, wann die Stichprobe für dieses Statistikobjekt erfasst wurde. type-
Ein String mit dem Wert
"outbound-rtp", der die Art der im Objekt enthaltenen Statistiken angibt.
Spezifikationen
| Spezifikation |
|---|
| Identifiers for WebRTC's Statistics API # dom-rtcstatstype-outbound-rtp |