RTCVideoSourceStats
Baseline
Weitgehend verfügbar
*
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Mai 2023 browserübergreifend verfügbar.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
Das RTCVideoSourceStats-Wörterbuch der WebRTC API liefert Statistikinformationen über eine Video-Spur (MediaStreamTrack), die einem oder mehreren Sendern (RTCRtpSender) zugeordnet ist.
Diese Statistiken können erhalten werden, indem der RTCStatsReport durchgegangen wird, der von RTCRtpSender.getStats() oder RTCPeerConnection.getStats() zurückgegeben wird, bis Sie einen Bericht mit dem type von media-source und einem kind von video finden.
Hinweis:
Für Videoinformationen über aus der Ferne bezogene Spuren (die empfangen werden), siehe RTCInboundRtpStreamStats.
Instanz-Eigenschaften
framesOptional-
Eine positive Zahl, die die Gesamtanzahl der von dieser Videoquelle ausgehenden Frames angibt.
framesPerSecondOptional-
Eine positive Zahl, die die Anzahl der von dieser Videoquelle in der letzten Sekunde ausgehenden Frames repräsentiert. Diese Eigenschaft ist in diesem Statistikobjekt während der ersten Sekunde ihrer Existenz nicht definiert.
heightOptional-
Eine Zahl, die die Höhe, in Pixeln, des letzten aus dieser Quelle stammenden Frames darstellt. Diese Eigenschaft ist in diesem Statistikobjekt nicht definiert, bis nach dem ersten Frame.
widthOptional-
Eine Zahl, die die Breite, in Pixeln, des neuesten aus dieser Quelle stammenden Frames darstellt. Diese Eigenschaft ist in diesem Statistikobjekt nicht definiert, bis nach dem ersten Frame.
Gemeinsame Eigenschaften von media-source
Die folgenden Eigenschaften sind sowohl in RTCVideoSourceStats als auch in RTCAudioSourceStats vorhanden:
trackIdentifier-
Ein String, der den
id-Wert des mit der Videoquelle assoziiertenMediaStreamTrackenthält. kind-
Ein String, der angibt, ob dieses Objekt Statistiken für eine Videoquelle oder eine Medienquelle repräsentiert. Für ein
RTCVideoSourceStatswird dies immervideosein.
Gemeinsame Instanz-Eigenschaften
Die folgenden Eigenschaften sind allen Statistikobjekten gemeinsam.
id-
Ein String, der das Objekt, das überwacht wird, um diesen Satz von Statistiken zu erzeugen, eindeutig identifiziert.
timestamp-
Ein
DOMHighResTimeStamp-Objekt, das die Zeit angibt, zu der die Probe für dieses Statistikobjekt genommen wurde. type-
Ein String mit dem Wert
"media-source", das angibt, dass das Objekt eine Instanz von entwederRTCAudioSourceStatsoderRTCVideoSourceStatsist.
Beschreibung
Die Schnittstelle bietet Statistiken über eine Video-Medienquelle, die einem oder mehreren Sendern zugeordnet ist.
Die Informationen umfassen einen Identifikator für den zugehörigen MediaStreamTrack, zusammen mit der Höhe und Breite des letzten von der Quelle gesendeten Frames, der Anzahl der von der Quelle gesendeten Frames und der Bildrate.
Beispiele
Dieses Beispiel zeigt, wie man das von RTCRtpSender.getStats() zurückgegebene Statistikobjekt durchlaufen kann, um die video-spezifischen media-source-Statistiken zu erhalten.
// where sender is an RTCRtpSender
const stats = await sender.getStats();
let videoSourceStats = null;
for (const report of stats.values()) {
if (report.type === "media-source" && report.kind === "video") {
videoSourceStats = report;
break;
}
}
// videoSourceStats will be null if the report did not include video source stats
const frames = videoSourceStats?.frames;
const fps = videoSourceStats?.framesPerSecond;
const width = videoSourceStats?.width;
const height = videoSourceStats?.height;
Spezifikationen
| Spezifikation |
|---|
| Identifiers for WebRTC's Statistics API # dom-rtcvideosourcestats |