RTCEncodedAudioFrame: RTCEncodedAudioFrame() Konstruktor
Baseline
2025
Newly available
Since November 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
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.
Syntax
new RTCEncodedAudioFrame(originalFrame);
new RTCEncodedAudioFrame(originalFrame, options);
Parameter
originalFrame-
Der zu kopierende Frame.
optionsOptional-
Dies ist ein Objekt mit der folgenden Eigenschaft:
metadataOptional-
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.
// 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
| Specification |
|---|
| WebRTC Encoded Transform # dom-rtcencodedaudioframe-constructor |