RTCEncodedVideoFrame: RTCEncodedVideoFrame() Konstruktor

Baseline 2025

Neu verfügbar

Seit November 2025 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.

Hinweis: Diese Funktion ist in Dedicated Web Workers verfügbar.

Der RTCEncodedVideoFrame() Konstruktor erstellt ein neues und vollständig unabhängiges RTCEncodedVideoFrame Objekt.

Das neue Objekt ist ein tiefes Duplikat der Originalobjektdaten und -metadaten, wobei alle im Optionsparameter angegebenen Metadaten die kopierten Werte überschreiben.

In diesem Artikel

Syntax

js
new RTCEncodedVideoFrame(originalFrame);
new RTCEncodedVideoFrame(originalFrame, options);

Parameter

originalFrame

Der zu kopierende Frame.

options Optional

Dies ist ein Objekt mit der folgenden Eigenschaft:

metadata Optional

Ein Objekt, das die Metadaten des Frames festlegt. Dies ist ein Objekt mit denselben Eigenschaften wie das von RTCEncodedVideoFrame.getMetadata() zurückgegebene Objekt.

Ausnahmen

TypeError
- Der Quellpuffer ist getrennt.
RangeError
- Die Zuordnung ist zu groß.

Beispiele

Klonen eines Frames mit geänderten Metadaten

Dieses Snippet zeigt, wie Sie einen Frame kopieren und seine Metadaten ändern können. In diesem Fall aktualisieren wir nur die Aufnahmezeit.

js
// Frame is an incoming RTCEncodedVideoFrame
frame.getMetadata();

const newFrame = new RTCEncodedVideoFrame(frame, {
  metadata: {
    captureTime: frame.metadata.captureTime + 3,
  },
});

Diese Art der Änderung kann nützlich sein, wenn Sie mehrere ausgehende Frames aus einem einzelnen eingehenden Frame erstellen müssen, beispielsweise um Medien an einen anderen Peer im Netzwerk weiterzuleiten. In der Regel müssen Sie die Metadaten eines Frames nicht ändern.

Spezifikationen

Spezifikation

WebRTC Encoded Transform
# dom-rtcencodedvideoframe-constructor

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
RTCEncodedVideoFrame
Konstruktor
1. RTCEncodedVideoFrame()
Instanzeigenschaften
Instanzmethoden
1. getMetadata()
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