AudioBuffer: copyToChannel() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2021年4月⁩.

copyToChannel() は AudioBuffer インターフェイスのメソッドで、元の配列から指定の AudioBuffer のチャンネルへとコピーします。

構文

copyToChannel(source, channelNumber)
copyToChannel(source, channelNumber, startInChannel)

引数

source: コピー元となるチャンネルデータの Float32Array です。
channelNumber: チャンネルデータのコピー先となる現在の AudioBuffer のチャンネル番号です。 channelNumber が AudioBuffer.numberOfChannels 以上の場合は INDEX_SIZE_ERR 例外が発生します。
startInChannel 省略可: オプションで、データをコピーする先のオフセット位置です。 startInChannel が AudioBuffer.length より大きければ、 INDEX_SIZE_ERR 例外が発生します。

返値

なし (undefined)。

例

const myArrayBuffer = audioCtx.createBuffer(2, frameCount, audioCtx.sampleRate);
const anotherArray = new Float32Array();
// myArrayBuffer の 2 番目のチャンネルからコピーする
myArrayBuffer.copyFromChannel(anotherArray, 1, 0);
// anotherArray から、 myArrayBuffer の 1 番目のチャンネルにコピーする。これで 2 つのチャンネルのデータは同じになる
myArrayBuffer.copyToChannel(anotherArray, 0, 0);