AudioContext.createChannelMerger()
AudioContext
インターフェースのcreateChannelMerger()
メソッドは、複数のオーディオストリームを1つに混合するChannelMergerNode
を生成します。
構文
var audioCtx = new AudioContext();
var merger = audioCtx.createChannelMerger(numberOfInputs);
引数
- numberOfInputs
- 入力オーディオストリームのチャンネルの数。指定がない場合は6になる。
戻り値
例
この例ではステレオトラックを分け、左右のチャンネルをそれぞれ別に処理する方法を示しています。これを使うためには、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