AudioParam

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2015年7月⁩.

* Some parts of this feature may have varying levels of support.

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

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

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

AudioParam.defaultValue 只读: 代表被具体的 AudioNode 创建的 AudioParam 的属性的初始值。
AudioParam.maxValue 只读: 代表参数有效范围的最大可能值。
AudioParam.minValue 只读: 代表参数有效范围的最小可能值。
AudioParam.value: 代表参数的当前浮点数音量值；初始化设定为 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);