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.

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.

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

Browser-Kompatibilität