AudioParam

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

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

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

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);

• 使用 Web Audio API