AudioData: copyTo()-Methode

Limited availability

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

Hinweis: Diese Funktion ist in Dedicated Web Workers verfügbar.

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

Syntax

copyTo(destination, options)

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

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.

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 });

Specification
WebCodecs # dom-audiodata-copyto

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.