RTCVideoSourceStats

Baseline Weitgehend verfügbar *

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Mai 2023 browserübergreifend verfügbar.

* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.

Das RTCVideoSourceStats Wörterbuch der WebRTC API liefert Statistikinformationen über eine Videospur (MediaStreamTrack), die mit einem oder mehreren Sendern (RTCRtpSender) verbunden ist.

Diese Statistiken können durch Iteration über den RTCStatsReport erhalten werden, der durch RTCRtpSender.getStats() oder RTCPeerConnection.getStats() zurückgegeben wird, bis Sie einen Bericht mit dem type von media-source und einem kind von video finden.

Hinweis: Für Informationen über Videospuren, die aus der Ferne bezogen werden (d.h. empfangen werden), siehe RTCInboundRtpStreamStats.

In diesem Artikel

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.

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.

js
// 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

Spezifikation

Identifiers for WebRTC's Statistics API
# dom-rtcvideosourcestats

Browser-Kompatibilität

JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

WebRTC API
RTCVideoSourceStats
Instanzeigenschaften
Verwandte Seiten für WebRTC
Anleitungen
1. Einführung in WebRTC-Protokolle
2. Einführung in das Real-time Transport Protocol (RTP)
3. WebRTC-Konnektivität
4. Herstellen einer Verbindung: Das WebRTC-Perfect-Negotiation-Muster
5. Lebenszyklus einer WebRTC-Sitzung
6. Signalisierung und Videoanrufe
7. Verwenden von WebRTC-Datenkanälen
8. Verwendung von DTMF mit WebRTC
9. Verwenden von WebRTC Encoded Transforms
10. Ein einfaches RTCDataChannel-Beispiel
11. Bau eines internetfähigen Telefons mit PeerJS