BaseAudioContext: createChannelSplitter() 方法

Baseline 已广泛支持

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

BaseAudioContext 接口的 createChannelSplitter() 方法用于创建一个 ChannelSplitterNode,该节点用于访问音频流的各个通道并单独处理它们。

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

语法

js
createChannelSplitter(numberOfOutputs)

参数

numberOfOutputs

您希望单独输出的输入音频流中的通道数;如果未指定此参数,则默认为 6。

返回值

一个 ChannelSplitterNode

示例

以下简单示例展示了如何分离立体声音轨(例如,一段音乐),并分别处理左声道和右声道。要使用它们,您需要使用 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-createchannelsplitter

浏览器兼容性

另见