音频开发 / 系统课时
用 GainNode 建立多路混音总线
用 GainNode 建立多路混音总线
当应用同时播放背景音乐、语音和提示音时,直接把所有源接到扬声器会失去统一的音量控制。本节用 GainNode 为每一路建立通道增益,再汇聚到主总线,形成可扩展、可验证的浏览器混音结构。
学习目标
- 理解“通道增益 → 主总线 → 输出”的连接关系
- 用
GainNode分别控制单路音量和整体音量 - 通过离线渲染验证多路信号的求和结果
混音总线的核心连接
Web Audio API 没有单独的“MixerNode”。一个节点输入端接收多条连接时,音频会先按通道规则求和,因此可以把多个通道 GainNode 都连接到同一个主 GainNode,把它当作逻辑上的混音总线。
每个通道增益负责本路电平,例如背景音乐和提示音可以有不同音量;主增益负责整体静音、淡入淡出或统一衰减。这样调整主音量时,不需要逐个修改所有音频源。

用离线上下文验证增益叠加
下面用 OfflineAudioContext 做确定性验证,不依赖扬声器和用户点击。两个恒定信号先经过各自通道增益,再进入主总线。理论结果为:A 路 0.25 × 0.4 = 0.10,B 路 0.50 × 0.2 = 0.10,求和得到 0.20,再经过主增益 0.5 后得到 0.10。
async function verifyMixBus() {
const ctx = new OfflineAudioContext(1, 8, 8000);
const sourceA = ctx.createConstantSource();
const sourceB = ctx.createConstantSource();
sourceA.offset.value = 0.25;
sourceB.offset.value = 0.50;
const channelA = new GainNode(ctx, { gain: 0.4 });
const channelB = new GainNode(ctx, { gain: 0.2 });
const master = new GainNode(ctx, { gain: 0.5 });
// 每一路先独立控制电平,再汇聚到同一个主总线输入。
sourceA.connect(channelA);
sourceB.connect(channelB);
channelA.connect(master);
channelB.connect(master);
master.connect(ctx.destination);
sourceA.start();
sourceB.start();
const rendered = await ctx.startRendering();
console.log(rendered.getChannelData(0)[0].toFixed(2));
}
verifyMixBus();预期输出
0.10这个结果同时验证了两个事实:同一输入上的多条连接会被求和,GainNode.gain 会对经过它的整路信号统一缩放。
从验证代码迁移到实时音频
在真实应用里,把 OfflineAudioContext 换成 AudioContext,把 ConstantSourceNode 换成 MediaElementAudioSourceNode、AudioBufferSourceNode 或其他实际音源即可。总线结构本身不变:音源只连自己的通道增益,通道增益统一连主增益,主增益再连 audioContext.destination 或后续效果节点。
如果需要静音单路,设置对应通道的 gain;如果需要全局淡出,只自动化主总线的 gain。这种分层能避免“改总音量时遍历所有源”的耦合。
设计多路总线时的边界
多路信号叠加后峰值可能超过常用的 -1 到 1 范围。Web Audio 内部使用浮点处理,但最终播放或导出阶段仍可能产生削波,因此混音时应预留余量,必要时在主总线后加入 DynamicsCompressorNode 或更严格的电平控制。
GainNode 适合做音量分组和总线,不负责把信号分配到指定左、右或更多离散声道。需要明确控制“哪一路进入哪个输出通道”时,应使用 ChannelMergerNode。