The copyFromChannel()
method of the AudioBuffer
interface copies the audio sample data from the specified channel of the AudioBuffer
to a specified Float32Array
.
Syntax
myArrayBuffer.copyFromChannel(destination, channelNumber, startInChannel);
Parameters
destination
- A
Float32Array
to copy the channel's samples to. channelNumber
- The channel number of the current
AudioBuffer
to copy the channel data from. startInChannel
Optional- 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
undefined
.
Exceptions
indexSizeError
- One of the input parameters has a value that is outside the accepted range:
- The value of
channelNumber
specifies a channel number which doesn't exist (that is, it's greater than or equal to the value ofnumberOfChannels
on the channel). - The value of
startInChannel
is outside the current range of samples that already exist in the source buffer; that is, it's greater than its currentlength
.
- The value of
Example
This example creates a new audio buffer, then copies the samples from another channel into it.
var myArrayBuffer = audioCtx.createBuffer(2, frameCount, audioCtx.sampleRate); var anotherArray = new Float32Array(length); myArrayBuffer.copyFromChannel(anotherArray, 1, 0);
Specification
Specification | Status | Comment |
---|---|---|
Web Audio API The definition of 'copyFromChannel' in that specification. |
Working Draft |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
copyFromChannel | Chrome Full support 14 | Edge Full support 13 | Firefox Full support 25 | IE No support No | Opera Full support 15 | Safari Full support 6 | WebView Android Full support Yes | Chrome Android Full support 18 | Firefox Android Full support 26 | Opera Android Full support 14 | Safari iOS ? | Samsung Internet Android Full support 1.0 |
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown