音频开发 / 系统课时

用 gain 控制播放音量

用 gain 控制播放音量

直接修改音频源并不是控制音量的好办法。更常见的做法是在源节点和最终输出之间插入 GainNode,让声音先经过增益处理再送到扬声器。本节会跑通这条最小链路,并验证不同 gain 值实际控制的是什么。

学习目标

  • 创建 GainNode,并把它放到音频源与 destination 之间
  • 理解 gain 是线性振幅倍率,而不是百分制音量
  • 用一段可运行代码验证增益节点确实参与了音频链路

GainNode 放在音频链路的哪里

GainNode 可以看成音频图中的一个音量处理节点。源节点产生音频数据,GainNode 对每个采样值乘以增益系数,处理后的数据再流向 AudioDestinationNode。

音频源经过 GainNode 到扬声器的增益链路

创建节点只需要 AudioContext.createGain()。新建节点的 gain.value 默认是 1,表示振幅保持不变;设置为 0.5 会把振幅缩小为一半,设置为 0 则相当于静音。

跑通一条可听见的增益链路

下面的代码可以直接粘贴到浏览器开发者工具 Console 中运行。它会动态创建一个按钮;点击按钮属于用户手势,可以避免浏览器自动播放策略阻止 AudioContext 启动。

js
const AudioContextClass = window.AudioContext || window.webkitAudioContext;
const button = document.createElement("button");
button.textContent = "播放 0.8 秒";
document.body.appendChild(button);

button.addEventListener("click", async () => {
  const context = new AudioContextClass();
  await context.resume();

  const oscillator = context.createOscillator();
  const gain = context.createGain();

  oscillator.type = "sine";
  oscillator.frequency.value = 440;
  gain.gain.value = 0.2;

  // 音频必须先经过 GainNode,再进入最终输出。
  oscillator.connect(gain);
  gain.connect(context.destination);

  oscillator.start();
  oscillator.stop(context.currentTime + 0.8);

  oscillator.addEventListener("ended", async () => {
    console.log(`gain: ${gain.gain.value}`);
    console.log("chain: oscillator -> gain -> destination");
    await context.close();
  });
});

预期输出

text
gain: 0.2
chain: oscillator -> gain -> destination

点击页面中新出现的按钮时,还应听到约 0.8 秒、频率为 440 Hz 的正弦波。控制台输出验证当前增益和连接顺序,实际扬声器响度还会受到系统音量与设备影响。

gain 值应该怎么选

常见控制范围是 0 到 1:0 用于静音,1 保持原始振幅,中间值用于衰减。Web Audio API 并没有强制把 gain 限制在这个区间,因此可以设置大于 1 的值,但多个较强信号叠加后可能超过可表示范围,产生削波失真。

如果音量需要平滑变化,不要在连续播放过程中反复硬改 gain.value。gain 本身是 AudioParam,可以使用 setValueAtTime()、linearRampToValueAtTime() 等自动化方法安排渐入、渐出和淡音,避免瞬间跳变产生爆音或点击声。

为什么不直接改音频源

把音量控制独立成 GainNode 后,同一个源可以继续接滤波器、分析器等节点,而音量逻辑仍然保持在固定位置。多个源还可以先汇入同一个 GainNode,形成统一的主音量控制。

因此,看到“播放声音并调节音量”这类需求时,优先把它理解为改变音频图:让源节点连接到 GainNode,再由 GainNode 连接到 destination,而不是试图修改 destination 或重新生成一份更小声的音频数据。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 gain 控制播放音量

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通