AudioBuffer
インターフェースのgetChannelData()メソッドは、引数channel(0が最初のチャンネル)に結び付けられたPCMデータを
Float32Array
で返します。
構文
var myArrayBuffer = audioCtx.createBuffer(2, frameCount, audioCtx.sampleRate); var nowBuffering = myArrayBuffer.getChannelData(channel);
戻り値
例
次の例は、2秒間のバッファを生成し、ホワイトノイズを書き込み、AudioBufferSourceNode
で再生します。コメントは何をしているかを簡単に説明しています。コードをすぐに実行することや、ソースコードを閲覧することもできます。
var audioCtx = new (window.AudioContext || window.webkitAudioContext)(); var button = document.querySelector('button'); var pre = document.querySelector('pre'); var myScript = document.querySelector('script'); pre.innerHTML = myScript.innerHTML; // ステレオ var channels = 2; // AudioContextのサンプルレートで2秒間の空のステレオバッファを生成する var frameCount = audioCtx.sampleRate * 2.0; var myArrayBuffer = audioCtx.createBuffer(2, frameCount, audioCtx.sampleRate); button.onclick = function() { // バッファにホワイトノイズを書き込む; // 単なる-1.0から1.0の間の乱数の値である for (var channel = 0; channel < channels; channel++) { // 実際のデータの配列を得る var nowBuffering = myArrayBuffer.getChannelData(channel); for (var i = 0; i < frameCount; i++) { // Math.random()は[0; 1.0]である // 音声は[-1.0; 1.0]である必要がある nowBuffering[i] = Math.random() * 2 - 1; } } // AudioBufferSourceNodeを得る // これはAudioBufferを再生するときに使うAudioNodeである var source = audioCtx.createBufferSource(); // AudioBufferSourceNodeにバッファを設定する source.buffer = myArrayBuffer; // AudioBufferSourceNodeを出力先に接続すると音声が聞こえるようになる source.connect(audioCtx.destination); // 音源の再生を始める source.start(); }
引数
- channel
- channelプロパティはデータを得るチャンネルの番号である。0が最初のチャンネルを表す。
channel
がAudioBuffer.numberOfChannels
以上ならば、INDEX_SIZE_ERR例外が発生する。
使用
Specification | Status | Comment |
---|---|---|
Web Audio API The definition of 'getChannelData' in that specification. |
草案 |
ブラウザ互換性
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support | 14 webkit | 23 | 未サポート | 15 webkit 22 (unprefixed) |
6 webkit |
Feature | Android | Chrome | Firefox Mobile (Gecko) | Firefox OS | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|---|
Basic support | 未サポート | 28 webkit | 25 | 1.2 | 未サポート | 未サポート | 6 webkit |