RTCEncodedAudioFrame: RTCEncodedAudioFrame() 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 RTCEncodedAudioFrame() Konstruktor erstellt ein neues und vollständig unabhängiges RTCEncodedAudioFrame-Objekt.

Das neue Objekt ist ein Tiefenkopie der ursprünglichen Objektdaten und Metadaten, wobei alle im Optionsparameter angegebenen Metadaten die kopierten Werte überschreiben.

In diesem Artikel

Syntax

js
new RTCEncodedAudioFrame(originalFrame);
new RTCEncodedAudioFrame(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 setzt. Dies ist ein Objekt mit den gleichen Eigenschaften wie das Objekt, das von RTCEncodedAudioFrame.getMetadata() zurückgegeben wird.

Ausnahmen

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

Beispiele

Klonen eines Frames mit modifizierten Metadaten

Dieses Beispiel zeigt, wie Sie einen Frame kopieren und dessen Metadaten ändern. In diesem Fall aktualisieren wir nur die Erfassungszeit.

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

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

Eine solche Modifikation kann nützlich sein, wenn Sie mehrere ausgehende Frames aus einem einzelnen eingehenden Frame erstellen müssen; zum Beispiel, um Medien an einen anderen Teilnehmer im Netzwerk weiterzuleiten. Im Allgemeinen müssen Sie die Metadaten eines Frames nicht ändern.

Spezifikationen

Spezifikation

WebRTC Encoded Transform
# dom-rtcencodedaudioframe-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
RTCEncodedAudioFrame
Konstruktor
1. RTCEncodedAudioFrame()
Instanzeigenschaften
1. data
2. timestamp
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