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 fr die erste Sekunde seines Bestehens nicht definiert.

height Optional

Eine Zahl, die die Hhe 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 enthlt, der mit der Videoquelle verknpft ist.

kind

Ein String, der angibt, ob dieses Objekt Statistiken fr eine Videoquelle oder eine Medienquelle darstellt. Fr 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 fr 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 fr das zugehrige MediaStreamTrack, die Hhe und Breite des letzten vom Quellgert gesendeten Frames, die Anzahl der gesendeten Frames und die Bildrate.

Beispiele

Dieses Beispiel zeigt, wie Sie das von RTCRtpSender.getStats() zurckgegebene Statistikobjekt durchlaufen knnen, 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-Kompatibilitt