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
copyTo(destination, options)
Parameter
destination
-
Ein
ArrayBuffer
, einTypedArray
oder einDataView
, 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, aberoptions.planeIndex
liegt außerhalb der Anzahl der verfügbaren Ebenen. - Das Format des
AudioData
-Objekts beschreibt ein verschachteltes Format, aberoptions.planeIndex
ist größer als0
.
Beispiele
Das folgende Beispiel kopiert die Ebene am Index 1
in einen Zielpuffer.
AudioData.copyTo(AudioBuffer, { planeIndex: 1 });
Spezifikationen
Specification |
---|
WebCodecs # dom-audiodata-copyto |
Browser-Kompatibilität
BCD tables only load in the browser