RTCVideoSourceStats

Instanz-Eigenschaften

frames Optional

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

framesPerSecond Optional

Eine positive Zahl, die die Anzahl der von dieser Videoquelle in der letzten Sekunde ausgehenden Frames reprsentiert. Diese Eigenschaft ist in diesem Statistikobjekt whrend der ersten Sekunde ihrer Existenz nicht definiert.

height Optional

Eine Zahl, die die Hhe, in Pixeln, des letzten aus dieser Quelle stammenden Frames darstellt. Diese Eigenschaft ist in diesem Statistikobjekt nicht definiert, bis nach dem ersten Frame.

width Optional

Eine Zahl, die die Breite, in Pixeln, des neuesten aus dieser Quelle stammenden Frames darstellt. Diese Eigenschaft ist in diesem Statistikobjekt nicht definiert, bis nach dem ersten Frame.

Gemeinsame Eigenschaften von media-source

Die folgenden Eigenschaften sind sowohl in RTCVideoSourceStats als auch in RTCAudioSourceStats vorhanden:

trackIdentifier

Ein String, der den id-Wert des mit der Videoquelle assoziierten MediaStreamTrack enthlt.

kind

Ein String, der angibt, ob dieses Objekt Statistiken fr eine Videoquelle oder eine Medienquelle reprsentiert. Fr ein RTCVideoSourceStats wird dies immer video sein.

Gemeinsame Instanz-Eigenschaften

Die folgenden Eigenschaften sind allen Statistikobjekten gemeinsam.

id

Ein String, der das Objekt, das berwacht wird, um diesen Satz von Statistiken zu erzeugen, eindeutig identifiziert.

timestamp

Ein DOMHighResTimeStamp-Objekt, das die Zeit angibt, zu der die Probe fr dieses Statistikobjekt genommen wurde.

type

Ein String mit dem Wert "media-source", das angibt, dass das Objekt eine Instanz von entweder RTCAudioSourceStats oder RTCVideoSourceStats ist.

Beschreibung

Die Schnittstelle bietet Statistiken ber eine Video-Medienquelle, die einem oder mehreren Sendern zugeordnet ist. Die Informationen umfassen einen Identifikator fr den zugehrigen MediaStreamTrack, zusammen mit der Hhe 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 man das von RTCRtpSender.getStats() zurckgegebene Statistikobjekt durchlaufen kann, um die video-spezifischen media-source-Statistiken zu erhalten.

// where sender is an RTCRtpSender
const stats = await sender.getStats();
let videoSourceStats = null;

for (const report of stats.values()) {
  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