AudioBuffer: copyToChannel() method
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{ APIRef("Web Audio API") }}
The copyToChannel() method of the {{ domxref("AudioBuffer") }} interface copies the samples to the specified channel of the AudioBuffer, from the source array.
Syntax
js-nolint
copyToChannel(source, channelNumber)
copyToChannel(source, channelNumber, startInChannel)Parameters
source- : A {{jsxref("Float32Array")}} that the channel data will be copied from.
channelNumber- : The channel number of the current {{domxref("AudioBuffer")}} to copy the channel
data to. If _channelNumber_ is greater than or equal to {{domxref("AudioBuffer.numberOfChannels")}}, an INDEX_SIZE_ERR will be thrown.
startInChannel{{optional_inline}}- : An optional offset to copy the data to. If _startInChannel_ is greater than
{{domxref("AudioBuffer.length")}}, an INDEX_SIZE_ERR will be thrown.
Return value
None ({{jsxref("undefined")}}).
Examples
js
const myArrayBuffer = audioCtx.createBuffer(2, frameCount, audioCtx.sampleRate);
const anotherArray = new Float32Array();
// Copy channel data from second channel of myArrayBuffer.
myArrayBuffer.copyFromChannel(anotherArray, 1, 0);
// Copy data from anotherArray to first channel of myArrayBuffer. Both channels have the same data now.
myArrayBuffer.copyToChannel(anotherArray, 0, 0);Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- Using the Web Audio API