RTCVideoSourceStats

Instanz-Eigenschaften

frames Optional

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

framesPerSecond Optional

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.

height Optional

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.

width Optional

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 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. Für ein RTCVideoSourceStats ist dies immer video.

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

Ein DOMHighResTimeStamp 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 von RTCAudioSourceStats oder RTCVideoSourceStats 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örige MediaStreamTrack, 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 von RTCRtpSender.getStats() zurückgegebene Statistikobjekt durchlaufen können, um die videospezifischen Medienquellenstatistiken 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

Browser-Kompatibilität