大网数据广告活动
Web 标准与前端开发

AudioParam

· 52CE 我爱测

Web Audio API 的 `AudioParam` 接口代表音频相关的参数,通常是 AudioNode(例如 GainNode.gain)的参数。

Web Audio API

Web Audio API 的 AudioParam 接口代表音频相关的参数,通常是 AudioNode(例如 GainNode.gain)的参数。

AudioParam 可以用于安排在特定时间并遵循特定模式设置一个具体的值或者数值的变化过程。

每个 AudioParam 都有一个初始化为空的事件列表,用于定义值在何时发生的具体变化。当该列表不为空时,将忽略使用 AudioParam.value 属性进行的更改。该事件列表使我们能够使用任意基于时间线的自动化曲线来安排必须在非常精确的时间发生的更改。使用的时间定义于 BaseAudioContext/currentTime 中。

AudioParam 类型

有两种类型的 AudioParam:a-rate 和 k-rate 参数。规范中为每个 AudioNode 都定义了其参数为 a-rate 还是 k-rate。

a-rate

a-rate AudioParam 获取音频信号的每个采样帧的当前音频参数值。

k-rate

k-rate AudioParam 对待处理的整个块使用相同的初始音频参数值,即 128 个采样帧。换句话说,其将相同的值应用于节点处理的音频中的每一帧。

实例属性

  • AudioParam.defaultValue
    • : 代表被具体的 AudioNode 创建的 AudioParam 的属性的初始值。
  • AudioParam.maxValue
    • : 代表参数有效范围的最大可能值。
  • AudioParam.minValue
    • : 代表参数有效范围的最小可能值。
  • AudioParam.value
    • : 代表参数的当前浮点数音量值;初始化设定为 AudioParam.defaultValue 的值。

实例方法

  • AudioParam.setValueAtTime()
    • : 参照 AudioContext.currentTime,安排在一个确切的时间,立即更改 AudioParam 的值。新的值由 value 参数给定。
  • AudioParam.linearRampToValueAtTime()
    • : 调整 AudioParam 的值,使其逐渐按线性变化。这个变化会从上一个事件指定的事件开始,跟随一个线性变化到参数给定的新值,并在 endTime 参数给定的时间到达新值。
  • AudioParam.exponentialRampToValueAtTime()
    • : 调整 AudioParam 的值,使其逐渐按指数变化。这个变化会从上一个事件指定的事件开始,跟随一个指数变化到参数给定的新值,并在 endTime 参数给定的时间到达新值。
  • AudioParam.setTargetAtTime()
    • : 安排逐渐改变 AudioParam 的值的开始时间。这个变化将从 startTime 指定的时间开始,并且以指定的方式向目标参数给定的值改变。指数衰减速率由 timeConstant 参数定义,以秒为单位。
  • AudioParam.setValueCurveAtTime()
    • : 调整 AudioParam 的值以跟随一组缩放到适应给定间隔的浮点数值,该间隔从给定的起始时间开始,持续一段给定的时长。
  • AudioParam.cancelScheduledValues()
    • : 取消所有安排的对 AudioParam 的未来的改变。
  • AudioParam.cancelAndHoldAtTime()
    • : 取消所有安排的对 AudioParam 的未来的改变,但是保持给定时间的值,直到将来的使用其他方法产生改变。

示例

首先,基础示例展示了如何设置 GainNode 的 gain 值。gain 是 a-rate AudioParam 的一个示例,因为该值可以针对音频的每个样本帧进行不同的设置。

const audioCtx = new AudioContext();

const gainNode = audioCtx.createGain();
gainNode.gain.value = 0;

下一个示例展示了如何修改 DynamicsCompressorNode 的一些参数值。这是 k-rate AudioParam 的一个示例,因为它是一次可以为整个音频块设置的值。

const compressor = audioCtx.createDynamicsCompressor();
compressor.threshold.setValueAtTime(-50, audioCtx.currentTime);
compressor.knee.setValueAtTime(40, audioCtx.currentTime);
compressor.ratio.setValueAtTime(12, audioCtx.currentTime);
compressor.attack.setValueAtTime(0, audioCtx.currentTime);
compressor.release.setValueAtTime(0.25, audioCtx.currentTime);

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。