RTCVideoSourceStats
Das RTCVideoSourceStats
-Wörterbuch der WebRTC API bietet statistische Informationen über einen Videotrack (MediaStreamTrack
), der an einen oder mehrere Sender (RTCRtpSender
) angehängt ist.
Diese Statistiken können durch Iteration des RTCStatsReport
, das von RTCRtpSender.getStats()
oder RTCPeerConnection.getStats()
zurückgegeben wird, erhalten werden, bis Sie einen Bericht mit dem type
von media-source
und einem kind
von video
finden.
Hinweis: Für Videoinformationen über Tracks mit entferntem Ursprung (die empfangen werden), siehe RTCInboundRtpStreamStats
.
Instanzeigenschaften
frames
Optional-
Eine positive Zahl, die die Gesamtzahl der Frames angibt, die von dieser Videoquelle stammen.
framesPerSecond
Optional-
Eine positive Zahl, die die Anzahl der Frames angibt, die in der letzten Sekunde von dieser Videoquelle stammen. Diese Eigenschaft ist in diesem Statistikobjekt für die erste Sekunde seiner Existenz nicht definiert.
height
Optional-
Eine Zahl, die die Höhe in Pixeln des letzten von dieser Quelle stammenden Frames darstellt. Diese Eigenschaft ist in diesem Statistikobjekt erst nach der Produktion des ersten Frames definiert.
width
Optional-
Eine Zahl, die die Breite in Pixeln des neuesten von dieser Quelle stammenden Frames darstellt. Diese Eigenschaft ist in diesem Statistikobjekt erst nach der Produktion des ersten Frames definiert.
Allgemeine Eigenschaften von media-source
Die folgenden Eigenschaften sind sowohl in RTCVideoSourceStats
als auch in RTCAudioSourceStats
vorhanden:
trackIdentifier
-
Ein String, der den
id
-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. Bei einem
RTCVideoSourceStats
ist dies immervideo
.
Allgemeine Instanzeigenschaften
Die folgenden Eigenschaften sind allen Statistikobjekten gemeinsam.
id
-
Ein String, der das Objekt, das überwacht wird, um diese Statistik zu erzeugen, eindeutig identifiziert.
timestamp
-
Ein
DOMHighResTimeStamp
-Objekt, das den Zeitpunkt angibt, zu dem das Muster für dieses Statistikobjekt aufgenommen wurde. type
-
Ein String mit dem Wert
"media-source"
, was darauf hinweist, dass das Objekt eine Instanz von entwederRTCAudioSourceStats
oderRTCVideoSourceStats
ist.
Beschreibung
Das Interface bietet Statistiken über eine Video-Medienquelle, die an einen oder mehrere Sender angehängt ist. Die Informationen beinhalten einen Bezeichner 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 Sie das stats-Objekt, das von RTCRtpSender.getStats()
zurückgegeben wird, durchlaufen können, um die spezifischen media-source-Statistiken für Video zu erhalten.
// where sender is an RTCRtpSender
const 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 stats
const frames = videoSourceStats?.frames;
const fps = videoSourceStats?.framesPerSecond;
const width = videoSourceStats?.width;
const height = videoSourceStats?.height;
Spezifikationen
Specification |
---|
Identifiers for WebRTC's Statistics API # dom-rtcvideosourcestats |
Browser-Kompatibilität
BCD tables only load in the browser