AudioContext.createChannelMerger()

AudioContextインターフェースのcreateChannelMerger()メソッドは、複数のオーディオストリームを1つに混合するChannelMergerNodeを生成します。

構文

var audioCtx = new AudioContext();
var merger = audioCtx.createChannelMerger(numberOfInputs);

引数

numberOfInputs: 入力オーディオストリームのチャンネルの数。指定がない場合は6になる。

戻り値

ChannelMergerNode

例

この例ではステレオトラックを分け、左右のチャンネルをそれぞれ別に処理する方法を示しています。これを使うためには、AudioNode.connect(AudioNode) (en-US)メソッドの2番目と3番目の引数を使い、接続元と接続先のチャンネルの番号を指定する必要があります。

var ac = new AudioContext();
ac.decodeAudioData(someStereoBuffer, function(data) {
 var source = ac.createBufferSource();
 source.buffer = data;
 var splitter = ac.createChannelSplitter(2);
 source.connect(splitter);
 var merger = ac.createChannelMerger(2);

 // 左チャンネルのボリュームのみ小さくする
 var gain = ac.createGain();
 gain.value = 0.5;
 splitter.connect(gain, 0);

 // splitterをmergerの2番目の入力にして戻す
 // ここではチャンネルを入れ替えることで、ステレオ音声の左右を逆にしている
 gain.connect(merger, 0, 1);
 splitter.connect(merger, 1, 0);

 var dest = ac.createMediaStreamDestination();

 // ChannelMergerNodeを使ったのでステレオのMediaStreamとなった
 // webオーディオグラフのWebRTCやMediaRecorderなどに渡す
 merger.connect(dest);
});

仕様

Specification	Status	Comment
Web Audio API createChannelMerger() の定義	勧告

ブラウザ互換性

BCD tables only load in the browser

参照

Using the Web Audio API (en-US)