BaseAudioContext:createChannelMerger() 方法

Baseline 已广泛支持

此特性已得到良好支持,可在多种设备和浏览器版本上使用。自 2021 年 4 月起,所有浏览器均已支持此特性。

BaseAudioContext 接口的 createChannelMerger() 方法创建一个 ChannelMergerNode,它将来自多个音频流的通道合并成一个单一的音频流。

注意: 创建 ChannelMergerNode 的推荐方式是使用 ChannelMergerNode() 构造函数;请参阅 创建 AudioNode

语法

js
createChannelMerger(numberOfInputs)

参数

numberOfInputs

输入音频流中的通道数,输出流将包含这些通道;如果未指定此参数,则默认为 6。

返回值

一个 ChannelMergerNode

示例

以下示例展示了如何分离立体声音轨(例如,一段音乐),并分别处理左右声道。要使用它们,您需要使用 AudioNode.connect(AudioNode) 方法的第二个和第三个参数,它们允许您指定要从中连接的通道索引和要连接到的通道索引。

js
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);

  // Reduce the volume of the left channel only
  const gainNode = ac.createGain();
  gainNode.gain.setValueAtTime(0.5, ac.currentTime);
  splitter.connect(gainNode, 0);

  // Connect the splitter back to the second input of the merger: we
  // effectively swap the channels, here, reversing the stereo image.
  gainNode.connect(merger, 0, 1);
  splitter.connect(merger, 1, 0);

  const dest = ac.createMediaStreamDestination();

  // Because we have used a ChannelMergerNode, we now have a stereo
  // MediaStream we can use to pipe the Web Audio graph to WebRTC,
  // MediaRecorder, etc.
  merger.connect(dest);
});

规范

规范
Web Audio API
# dom-baseaudiocontext-createchannelmerger

浏览器兼容性

另见