AudioData: copyTo()-Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Hinweis: Dieses Feature ist verfügbar in Dedicated Web Workers.

Die copyTo()-Methode der AudioData-Schnittstelle kopiert eine Ebene eines AudioData-Objekts in einen Zielpuffer.

Syntax

js
copyTo(destination, options)

Parameter

destination

Ein ArrayBuffer, ein TypedArray oder ein DataView, in den die Ebene kopiert werden soll.

options

Ein Objekt, das Folgendes enthält:

planeIndex

Der Index der Ebene, aus der kopiert werden soll.

frameOffset Optional

Ein Integer, der einen Versatz in die Ebenendaten angibt, ab dem die Kopie beginnen soll. Standardmäßig 0.

frameCount Optional

Ein Integer, der die Anzahl der zu kopierenden Frames angibt. Wird er nicht angegeben, werden alle Frames in der Ebene kopiert, beginnend mit dem in frameOffset angegebenen Frame.

Rückgabewert

Undefiniert.

Ausnahmen

InvalidStateError DOMException

Wird ausgelöst, wenn das AudioData-Objekt übertragen wurde.

RangeError

Wird ausgelöst, wenn eine der folgenden Bedingungen erfüllt ist:

  • Die Länge der Probe ist länger als die Länge des Ziels.
  • Das Format des AudioData-Objekts beschreibt ein planaritisches Format, aber options.planeIndex liegt außerhalb der Anzahl der verfügbaren Ebenen.
  • Das Format des AudioData-Objekts beschreibt ein verschachteltes Format, aber options.planeIndex ist größer als 0.

Beispiele

Das folgende Beispiel kopiert die Ebene am Index 1 in einen Zielpuffer.

js
AudioData.copyTo(AudioBuffer, { planeIndex: 1 });

Spezifikationen

Specification
WebCodecs
# dom-audiodata-copyto

Browser-Kompatibilität

BCD tables only load in the browser