AudioData: copyTo()-Methode

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.

Undefiniert.

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.

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

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