AudioBuffer: copyFromChannel() method
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("Web Audio API")}}
The **copyFromChannel()** method of the {{domxref("AudioBuffer")}} interface copies the audio sample data from the specified channel of the AudioBuffer to a specified {{jsxref("Float32Array")}}.
Syntax
js-nolint
copyFromChannel(destination, channelNumber, startInChannel)Parameters
destination- : A {{jsxref("Float32Array")}} to copy the channel's samples to.
channelNumber- : The channel number of the current
AudioBufferto copy the channel data
from.
startInChannel{{optional_inline}}- : An optional offset into the source channel's buffer from which to begin copying
samples. If not specified, a value of 0 (the beginning of the buffer) is assumed by default.
Return value
None ({{jsxref("undefined")}}).
Exceptions
IndexSizeError{{domxref("DOMException")}}- : The value of
channelNumberspecifies a channel number which doesn't exist (that is, it's greater than or equal to the value of {{domxref("AudioBuffer.numberOfChannels", "numberOfChannels")}} on the buffer).
Examples
This example creates a new audio buffer, then copies the samples from another channel into it.
js
const myArrayBuffer = audioCtx.createBuffer(2, frameCount, audioCtx.sampleRate);
const anotherArray = new Float32Array(length);
myArrayBuffer.copyFromChannel(anotherArray, 1, 0);Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- Using the Web Audio API