音频开发 / 系统课时
区分 AudioParam 的两类参数
区分 AudioParam 的两类参数
当你给音量、播放速率或压缩器参数安排自动化时,真正决定“多久取一次参数值”的不是 JavaScript 更新频率,而是 AudioParam 的自动化速率。本节用 a-rate 与 k-rate 建立判断框架,避免把所有参数都当成逐采样变化。
学习目标
- 说清 a-rate 与 k-rate 的取值粒度差异
- 能根据常见节点判断参数属于哪一类
- 知道什么时候必须关心参数的自动化速率
两类参数差在哪
a-rate 参数会为音频信号的每个采样帧取得当前参数值;k-rate 参数则在一个渲染块内使用同一个初始参数值,Web Audio 当前常见的渲染块是 128 个采样帧。前者适合需要细粒度连续变化的参数,后者更像控制速率参数。([MDN Web Docs][1])

a-rate 并不等于“JavaScript 每个采样都执行一次”。主线程中的事件、定时器或动画帧仍按各自节奏运行;需要精确跟随音频时间轴时,应把变化交给 AudioParam 的自动化事件,由音频渲染线程计算参数值。
用常见节点建立判断
| 参数 | 类型 | 典型用途 |
|---|---|---|
GainNode.gain |
a-rate | 音量包络、快速增益变化 |
AudioBufferSourceNode.playbackRate |
k-rate | 调整缓冲区播放速度 |
DynamicsCompressorNode.ratio |
k-rate | 设置压缩比 |
GainNode.gain 被定义为 a-rate,而 AudioBufferSourceNode.playbackRate 与 DynamicsCompressorNode.ratio 是 k-rate。它们在 JavaScript 中都表现为 AudioParam,所以不能仅凭对象类型判断自动化速率,应查看具体节点参数的定义。([MDN Web Docs][2])
下面的代码可直接在浏览器开发者工具控制台运行,用来确认这些属性都是 AudioParam,并观察各自默认值。自动化速率来自节点规范,不是通过 constructor.name 推断。
(async () => {
const ctx = new AudioContext();
const gain = ctx.createGain();
const source = ctx.createBufferSource();
const compressor = ctx.createDynamicsCompressor();
// 三个属性都返回 AudioParam,但自动化速率由各节点参数定义。
console.log("GainNode.gain:", gain.gain.constructor.name, gain.gain.defaultValue);
console.log(
"AudioBufferSourceNode.playbackRate:",
source.playbackRate.constructor.name,
source.playbackRate.defaultValue,
);
// defaultValue 只表示初始值,不能用来推断 a-rate 或 k-rate。
console.log(
"DynamicsCompressorNode.ratio:",
compressor.ratio.constructor.name,
compressor.ratio.defaultValue,
);
await ctx.close();
})();预期输出
GainNode.gain: AudioParam 1
AudioBufferSourceNode.playbackRate: AudioParam 1
DynamicsCompressorNode.ratio: AudioParam 12什么时候必须关心速率
当参数直接塑造快速包络、调制或其他细粒度变化时,a-rate 的逐采样取值能力更重要;如果参数本身只需要按渲染块更新,k-rate 可以满足控制需求。k-rate 并不表示“不能自动化”,而是自动化结果在一个渲染块内保持同值。
理解这一区别后,后续看到 setValueAtTime()、ramp 或曲线自动化时,就能先判断参数以什么粒度参与渲染,而不是只关注 API 调用了多少次。