BaseAudioContext: createChannelMerger() メソッド

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2021年4月以降、すべてのブラウザーで利用可能です。

もっと詳しく
完全な互換性情報を見る

createChannelMerger() は BaseAudioContext インターフェイスのメソッドで、 ChannelMergerNode を作成します。これは複数の音声ストリームのチャンネルを一つの音声ストリームに結合します。

メモ: ChannelMergerNode() コンストラクターは ChannelMergerNode を作成するための推奨される方法です。 AudioNode の作成を参照してください。

構文

createChannelMerger(numberOfInputs)

引数

numberOfInputs: 出力ストリームに含まれる、入力オーディオストリームのチャンネル数です。この引数が指定されていない場合の既定値は 6 です。

返値

ChannelMergerNode です。

例

次の例では、ステレオトラック(例えば音楽)を分離し、左チャンネルと右チャンネルを別々に処理する方法を示しています。これを使うには、 AudioNode.connect(AudioNode) メソッドの第 2、第 3 引数を使って、接続元のチャンネルのインデックスと接続先のチャンネルのインデックスの両方を指定することが必要です。

const ac = new AudioContext();
ac.decodeAudioData(someStereoBuffer, (data) => {
 const source = ac.createBufferSource();
 source.buffer = data;
 const splitter = ac.createChannelSplitter(2);
 source.connect(splitter);
 const merger = ac.createChannelMerger(2);
 // 左チャンネルのボリュームのみ小さくする
 const gainNode = ac.createGain();
 gainNode.gain.setValueAtTime(0.5, ac.currentTime);
 splitter.connect(gainNode, 0);
 // スプリッターをマージャーの 2 番目の入力に接続すると、チャンネルが効果的に交換され、
 // ステレオイメージが反転します。
 gainNode.connect(merger, 0, 1);
 splitter.connect(merger, 1, 0);
 const dest = ac.createMediaStreamDestination();
 // ChannelMergerNode を使っているので、ステレオの MediaStream が
 // できました。これでウェブオーディオグラフを WebRTC や MediaRecorder などに
 // パイプするのに使えます。
 merger.connect(dest);
});