DasRTCVideoSourceStats Wörterbuch derWebRTC API liefert Statistikinformationen über eine Videospur (MediaStreamTrack), die mit einem oder mehreren Sendern (RTCRtpSender) verbunden ist.

Diese Statistiken können durch Iteration über denRTCStatsReport erhalten werden, der durchRTCRtpSender.getStats() oderRTCPeerConnection.getStats() zurückgegeben wird, bis Sie einen Bericht mit demtype vonmedia-source und einemkind vonvideo finden.

Instanz-Eigenschaften

framesOptional

Eine positive Zahl, die die Gesamtanzahl der von dieser Videoquelle stammenden Frames angibt.

framesPerSecondOptional

Eine positive Zahl, die die Anzahl der in der letzten Sekunde von dieser Videoquelle stammenden Frames darstellt.Diese Eigenschaft ist auf diesem Statistikobjekt für die erste Sekunde seines Bestehens nicht definiert.

heightOptional

Eine Zahl, die die Höhe in Pixeln des letzten von dieser Quelle stammenden Frames darstellt.Diese Eigenschaft ist auf diesem Statistikobjekt erst definiert, nachdem der erste Frame produziert wurde.

widthOptional

Eine Zahl, die die Breite in Pixeln des letzten von dieser Quelle stammenden Frames darstellt.Diese Eigenschaft ist auf diesem Statistikobjekt erst definiert, nachdem der erste Frame produziert wurde.

Allgemeine Eigenschaften von Medienquellen

Die folgenden Eigenschaften sind sowohl inRTCVideoSourceStats als auch inRTCAudioSourceStats vorhanden:

trackIdentifier

Ein String, der denid Wert desMediaStreamTrack enthält, der mit der Videoquelle verknüpft ist.

kind

Ein String, der angibt, ob dieses Objekt Statistiken für eine Videoquelle oder eine Medienquelle darstellt. Für einRTCVideoSourceStats ist dies immervideo.

Allgemeine Instanz-Eigenschaften

Die folgenden Eigenschaften sind allen Statistikobjekten gemeinsam.

id

Ein String, der das Objekt, das überwacht wird, um diese Statistiksammlung zu erzeugen, eindeutig identifiziert.

timestamp

EinDOMHighResTimeStamp Objekt, das den Zeitpunkt angibt, zu dem die Probe für dieses Statistikobjekt genommen wurde.

type

Ein String mit dem Wert"media-source", der angibt, dass das Objekt eine Instanz entweder vonRTCAudioSourceStats oderRTCVideoSourceStats ist.

Beschreibung

Die Schnittstelle liefert Statistiken über eine Video-Medienquelle, die mit einem oder mehreren Sendern verbunden ist.Die Informationen umfassen einen Bezeichner für das zugehörigeMediaStreamTrack, die Höhe und Breite des letzten vom Quellgerät gesendeten Frames, die Anzahl der gesendeten Frames und die Bildrate.

Beispiele

Dieses Beispiel zeigt, wie Sie das vonRTCRtpSender.getStats() zurückgegebene Statistikobjekt durchlaufen können, um die videospezifischen Medienquellenstatistiken zu erhalten.

// where sender is an RTCRtpSenderconst stats = await sender.getStats();let videoSourceStats = null;stats.forEach((report) => {  if (report.type === "media-source" && report.kind==="video") {    videoSourceStats = report;    break;  }});// videoSourceStats will be null if the report did not include video source statsconst frames = videoSourceStats?.frames;const fps = videoSourceStats?.framesPerSecond;const width = videoSourceStats?.width;const height = videoSourceStats?.height;

Spezifikationen

Browser-Kompatibilität