RTCVideoSourceStats

Instanzvariablen

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 während der ersten Sekunde seiner Existenz nicht definiert.

height Optional

Eine Zahl, die die Höhe, in Pixel, des letzten Frames angibt, der von dieser Quelle stammt. Diese Eigenschaft ist in diesem Statistikobjekt erst nach der Erzeugung des ersten Frames definiert.

width Optional

Eine Zahl, die die Breite, in Pixel, des aktuellsten Frames angibt, der von dieser Quelle stammt. Diese Eigenschaft ist in diesem Statistikobjekt erst nach der Erzeugung des ersten Frames definiert.

Gemeinsame Eigenschaften der Medienquelle

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

trackIdentifier

Ein String, der den id Wert des mit der Videoquelle verbundenen MediaStreamTrack enthält.

kind

Ein String, der angibt, ob dieses Objekt Statistiken für eine Videoquelle oder eine Medienquelle repräsentiert. Für ein RTCVideoSourceStats ist dies immer video.

Gemeinsame Instanzvariablen

Die folgenden Eigenschaften sind für alle Statistikobjekte gemeinsam.

id

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

timestamp

Ein DOMHighResTimeStamp-Objekt, das den Zeitpunkt angibt, zu dem die Probe für dieses Statistikobjekt entnommen wurde.

type

Ein String mit dem Wert "media-source", der angibt, dass es sich bei dem Objekt entweder um eine Instanz von RTCAudioSourceStats oder RTCVideoSourceStats handelt.

Beschreibung

Die Schnittstelle liefert Statistiken über eine Videomedienquelle, die an einen oder mehrere Sender angeschlossen ist. Die Informationen umfassen eine Kennung für das zugehörige 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, iterieren könnten, um die medienquellenspezifischen Videostatistiken 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