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
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
media-source stats | ||||||||||||
audioLevel in 'media-source' stats | ||||||||||||
frames in 'media-source' stats for video | ||||||||||||
framesPerSecond in 'media-source' stats for video | ||||||||||||
height in 'media-source' stats for video | ||||||||||||
id in 'media-source' stats | ||||||||||||
kind in 'media-source' stats | ||||||||||||
timestamp in 'media-source' stats | ||||||||||||
totalAudioEnergy in 'media-source' stats | ||||||||||||
totalSamplesDuration in 'media-source' stats | ||||||||||||
trackIdentifier in 'media-source' stats | ||||||||||||
type in 'media-source' stats | ||||||||||||
width in 'media-source' stats for video |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.