RTCVideoSourceStats

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.

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.

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.

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.

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;