AudioBuffer: Methode copyFromChannel()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2021 browserübergreifend verfügbar.
Die Methode copyFromChannel() der Schnittstelle AudioBuffer kopiert die Audiosample-Daten aus dem angegebenen Kanal des AudioBuffer in ein angegebenes Float32Array.
Syntax
copyFromChannel(destination, channelNumber, startInChannel)
Parameter
destination-
Ein
Float32Array, in das die Samples des Kanals kopiert werden. channelNumber-
Die Kanalnummer des aktuellen
AudioBuffer, aus dem die Kanaldaten kopiert werden. startInChannelOptional-
Ein optionaler Versatz im Puffer des Quellkanals, ab dem Samples kopiert werden. Wenn kein Wert angegeben wird, gilt standardmäßig 0 (der Anfang des Puffers).
Rückgabewert
Keiner (undefined).
Ausnahmen
IndexSizeErrorDOMException-
Der Wert von
channelNumbergibt eine Kanalnummer an, die nicht existiert (das heißt, er ist größer oder gleich dem Wert vonnumberOfChannelsdes Puffers).
Beispiele
Dieses Beispiel erstellt einen neuen Audiopuffer und kopiert anschließend die Samples aus einem anderen Kanal hinein.
const myArrayBuffer = audioCtx.createBuffer(2, frameCount, audioCtx.sampleRate);
const anotherArray = new Float32Array(length);
myArrayBuffer.copyFromChannel(anotherArray, 1, 0);
Spezifikationen
| Spezifikation |
|---|
| Web Audio API # dom-audiobuffer-copyfromchannel |