音频开发 / 系统课时
看懂 connect 的输入输出关系
看懂 connect 的输入输出关系
connect() 决定了音频数据究竟流向哪里。链路中只要漏连一个节点、接错方向,或者误解分支关系,就可能出现完全无声或处理结果不符合预期。本节通过级联和分支两种连接方式,把 AudioNode 的输入、输出和数据流一次看清。
学习目标
- 理解
source.connect(destination)表示输出流向输入 - 区分节点级联与一个输出连接多个下游节点的分支
- 使用
numberOfInputs、numberOfOutputs辅助判断节点能否按预期连接
connect 描述的是数据流向
最常见的调用形式是 source.connect(destination)。左侧节点提供输出,参数中的节点接收输入,因此阅读音频图时可以直接按“左边流向右边”理解。
例如 oscillator.connect(gain) 表示振荡器产生的音频进入增益节点;随后执行 gain.connect(context.destination),才会把处理后的声音送往最终输出。
一个节点是否有输入或输出取决于节点类型。OscillatorNode 是声音源,没有音频输入但有一个输出;GainNode 有输入也有输出;AudioDestinationNode 接收最终声音,因此有输入而没有继续向后的输出。
级联与分支不是一回事
多个 connect() 可以形成串联处理,也可以让同一个输出产生分支。串联时,数据按节点顺序逐级处理;分支时,同一份上游音频会送往多个下游节点。

分支经常用于“一边播放、一边分析”这类场景。例如同一个 GainNode 可以连接到扬声器,同时把音频发送给 AnalyserNode 获取频谱数据。分支不会自动把下游节点串联起来,每一条连接都需要显式建立。
用代码观察输入输出和分支
下面的代码可直接粘贴到浏览器开发者工具 Console 中。点击生成的按钮后,它会建立一条播放链路,并从 GainNode 再分出一条连接到分析节点。
const AudioContextClass = window.AudioContext || window.webkitAudioContext;
const button = document.createElement("button");
button.textContent = "播放并检查连接";
document.body.appendChild(button);
button.addEventListener("click", async () => {
const context = new AudioContextClass();
await context.resume();
const oscillator = context.createOscillator();
const gain = context.createGain();
const analyser = context.createAnalyser();
oscillator.frequency.value = 440;
gain.gain.value = 0.15;
analyser.fftSize = 32;
// 先形成主播放链路,再从 GainNode 建立分析分支。
oscillator.connect(gain);
gain.connect(context.destination);
gain.connect(analyser);
console.log(`oscillator inputs/outputs: ${oscillator.numberOfInputs}/${oscillator.numberOfOutputs}`);
console.log(`gain inputs/outputs: ${gain.numberOfInputs}/${gain.numberOfOutputs}`);
console.log(`destination inputs/outputs: ${context.destination.numberOfInputs}/${context.destination.numberOfOutputs}`);
console.log("branch: gain -> destination + analyser");
oscillator.start();
oscillator.stop(context.currentTime + 0.8);
oscillator.addEventListener("ended", async () => {
await context.close();
});
});预期输出
oscillator inputs/outputs: 0/1
gain inputs/outputs: 1/1
destination inputs/outputs: 1/0
branch: gain -> destination + analyser点击按钮后还应听到约 0.8 秒的声音。这里 AnalyserNode 是额外分支,而不是主播放链路中的必经节点,所以移除 gain.connect(analyser) 不会阻止声音进入 destination。
指定输出和输入索引
connect() 还可以显式指定输出和输入索引,形式为 source.connect(destination, outputIndex, inputIndex)。绝大多数只有单一输入输出的常用节点直接使用默认形式即可;只有处理多输出或多输入节点时,索引参数才真正重要。
索引从 0 开始,并且必须落在节点实际拥有的输入输出范围内。把不存在的输出或输入索引传给 connect() 会抛出异常,因此排查复杂音频图时,可以先检查节点类型及其 numberOfInputs、numberOfOutputs,再检查索引。
无声时按链路顺序检查
遇到节点都创建成功但没有声音时,先从源节点沿箭头逐段检查:源是否已经 start(),源是否连接到第一个处理节点,每个处理中间节点是否继续连接,最后是否确实到达 context.destination。同时确认 AudioContext 已经处于运行状态,以及中途的 GainNode 没有被设置为 0。
理解 connect() 后,复杂音频图也可以按相同方法拆开:每一条调用只回答一个问题——哪个节点的输出,要送进哪个节点的输入。只要沿数据流逐段验证,级联、分支以及后续加入的滤波和分析节点都能用同一套思路定位。