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 des MediaStreamTrack 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 immer video.

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 entweder RTCAudioSourceStats oder RTCVideoSourceStats 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.

js
// 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 GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
media-source stats
audioLevel in 'media-source' stats
Experimental
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
Experimental
totalSamplesDuration in 'media-source' stats
Experimental
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.