音频开发 / 系统课时

区分 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 与 k-rate 在音频渲染块中的取值粒度

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 推断。

js
(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();
})();

预期输出

text
GainNode.gain: AudioParam 1
AudioBufferSourceNode.playbackRate: AudioParam 1
DynamicsCompressorNode.ratio: AudioParam 12

什么时候必须关心速率

当参数直接塑造快速包络、调制或其他细粒度变化时,a-rate 的逐采样取值能力更重要;如果参数本身只需要按渲染块更新,k-rate 可以满足控制需求。k-rate 并不表示“不能自动化”,而是自动化结果在一个渲染块内保持同值。

理解这一区别后,后续看到 setValueAtTime()、ramp 或曲线自动化时,就能先判断参数以什么粒度参与渲染,而不是只关注 API 调用了多少次。

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

目录与阅读设置

阅读设置

17

记录一个想法

区分 AudioParam 的两类参数

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

登录哪都通