AudioBuffer.copyFromChannel()
copyFromChannel()
は AudioBuffer
インターフェイスのメソッドで、 AudioBuffer
の指定されたチャンネルから音声サンプルデータを指定された Float32Array
へコピーします。
構文
copyFromChannel(destination, channelNumber, startInChannel);
引数
destination
-
チャンネルのサンプルのコピー先となる
Float32Array
です。 channelNumber
-
チャンネルデータをコピーする現在の
AudioBuffer
のチャンネル数です。 startInChannel
省略可-
オプションで、ソースチャンネルバッファー内でサンプルのコピーを始める位置のオフセットです。指定されていない場合は、既定で 0 の値(バッファーの先頭)とみなされます。
返値
undefined
です。
例外
indexSizeError
-
入力引数のうちの一つが、受付可能な範囲の外にある場合。
channelNumber
の値が存在しないチャンネル番号を指定している場合(つまり、チャンネルのnumberOfChannels
以上である場合)。startInChannel
の値がソースバッファーの中に既に存在するサンプルの現在の範囲の外にある場合。つまり、現在のlength
より大きい場合。
例
この例では新しい音声バッファーを生成し、他のチャンネルからサンプルをコピーします。
var myArrayBuffer = audioCtx.createBuffer(2, frameCount, audioCtx.sampleRate);
var anotherArray = new Float32Array(length);
myArrayBuffer.copyFromChannel(anotherArray, 1, 0);
仕様書
Specification |
---|
Web Audio API # dom-audiobuffer-copyfromchannel |
ブラウザーの互換性
BCD tables only load in the browser