AudioData: copyTo() Methode

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

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

Die copyTo() Methode des AudioData Interfaces 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 ganzzahliger Wert, der den Versatz des ersten zu kopierenden Rahmens innerhalb der Ebene angibt. Standardmäßig 0.
frameCount Optional: Ein ganzzahliger Wert, der die Anzahl der zu kopierenden Rahmen angibt. Wenn weggelassen, werden alle Rahmen von frameOffset bis zum Ende der Ebene kopiert.
format Optional: Ein String, der das Audioformat angibt, in das die Quellproben konvertiert werden sollen, wenn sie in das Ziel kopiert werden. Dies kann einer der folgenden Werte sein: "u8", "s16", "s32", "f32", "u8-planar", "s16-planar", "s32-planar", und "f32-planar" (siehe AudioData.format für weitere Informationen). Beachten Sie, dass "f32-planar" unterstützt werden muss. Wenn nicht angegeben, werden die Proben im eigenen Format des AudioData kopiert.

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 Ziellänge.
Das Format des AudioData Objekts beschreibt ein Planarformat, aber options.planeIndex liegt außerhalb der verfügbaren Anzahl von Ebenen.
Das Format des AudioData Objekts beschreibt ein verschachteltes Format, aber options.planeIndex ist größer als 0.

NotSupportedError DOMException

Wird ausgelöst, wenn das angegebene format zum Konvertieren der Daten nicht unterstützt wird.

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

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

Spezifikation
WebCodecs # dom-audiodata-copyto

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.