AudioBufferSourceNode

AudioBufferSourceNodeはAudioScheduledSourceNodeを継承するインタフェースで、AudioBufferに保存されたインメモリ音声データからなるオーディオソースを表します。AudioBufferSourceNodeは、再生するタイミングに高い正確性が求められる音声を繰り返し再生する場合特に有益です。例えば、特定のリズムに合わせて、ディスクやネットワークからではなくメモリから読みだした音声を再生するといった場合です。正確なタイミングで音声を再生したいものの、音声データがディスクやネットワークから読み込まれる必要がある場合はAudioWorkletNode (en-US)を使用してください。

AudioBufferSourceNode は入力がなく、その出力は 1 つで、出力されるチャンネル数は AudioBufferSourceNode.buffer で参照される AudioBuffer のチャンネル数によって決まります。この属性値が NULL の場合、つまりバッファがセットされていない場合、無音が出力されます。AudioBufferSourceNodeは一度しか再生できません。つまり、AudioBufferSourceNode.start()の呼び出しは一度しかできません。もし、再び再生するならば、別のAudioBufferSourceNodeを生成する必要があります。これらのノードは安価に生成でき、AudioBufferは何度も再生できます。よくAudioBufferSourceNodeは「撃ちっぱなし」で使わなければならない、と言われます。つまり、一度再生を始めると、そのノードへの参照はなくなり、自動的にガベージコレクトされます。

AudioBufferSourceNode.stop()は何度も呼ぶことができます。AudioBufferSourceNodeがバッファの最後に達していないならば、最後の呼び出しがその前の呼び出しを上書きします。

The AudioBufferSourceNode takes the content of an AudioBuffer and m

Number of inputs	`0`
Number of outputs	`1`
Channel count	defined by the associated `AudioBuffer`

コンストラクタ

AudioBufferSourceNode() (en-US): AudioBufferSourceNode オブジェクトを新しく作成して返します。AudioBufferSourceNodeはAudioContext.createBufferSource()メソッドを用いてインスタンス化することができます。

プロパティ

親であるAudioNodeのプロパティを継承しています。

AudioBufferSourceNode.buffer (en-US): 再生される音声のAudioBufferです。NULLの場合1チャンネルからなる無音の音声（すべてのサンプルが0.0）です。
AudioBufferSourceNode.detune (en-US): セント単位のデチューンを表すk-rate (en-US)AudioParamです。この値とplaybackRateの組み合わせで音声が再生される速度が決定されます。デフォルト値は0（デチューンなし）で、公称範囲は -∞ から ∞ です。
AudioBufferSourceNode.loop: AudioBufferの最後に達したとき再び再生するかを表すブール値です。デフォルトはfalseです。
AudioBufferSourceNode.loopStart (en-US) 省略可: loopがtrueのとき、AudioBufferを再び再生する位置(秒単位)を表す浮動小数点数です。デフォルトは0で、これは音声の初めからループが始まることを意味します。
AudioBufferSourceNode.loopEnd (en-US) 省略可: loopがtrueのとき、AudioBufferの再生を停止してloopStartの地点に戻る位置(秒単位)を表す浮動小数点数です。デフォルトは0です。
AudioBufferSourceNode.playbackRate (en-US): 再生される音声の速度要素を表すa-rate AudioParamです。この値が1.0のとき通常のサンプリングレートで出力されます。出力にピッチの修正が適用されない場合は、サンプルのピッチの変更に使うことができます。この値とdetuneの組み合わせで音声が再生される速度が決定されます。

イベントハンドラ

親であるAudioScheduledSourceNodeのイベントハンドラを継承しています。

AudioBufferSourceNode.onended: ended (en-US)イベントに関するコールバックを格納したイベントハンドラです。

メソッド

親であるAudioNodeのメソッドを継承しています。

AudioBufferSourceNode.start(): 設定された音声の再生をスケジュールするか、直ちに再生します。
AudioBufferSourceNode.stop(): 設定された音声の再生の停止をスケジュールするか、直ちに停止します。

例

次の例は、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();
}

注: decodeAudioDataの例は、AudioContext.decodeAudioDataのページを参照してください。

仕様

Specification	Status	Comment
Web Audio API AudioBufferSourceNode の定義	草案

ブラウザ互換性

BCD tables only load in the browser

Chrome notes

The buffer property was removed in 44.0.