AudioParam

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

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

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

AudioParam.defaultValue (en-US) 只读

代表被具体的 AudioNode 创建的 AudioParam 的属性的初始值。

AudioParam.maxValue (en-US) 只读

代表参数有效范围的最大可能值。

AudioParam.minValue (en-US) 只读

代表参数有效范围的最小可能值。

AudioParam.value (en-US)

代表参数的当前浮点数音量值；初始化设定为 defaultValue (en-US) 的值。

AudioParam.setValueAtTime() (en-US)

参照 AudioContext.currentTime，安排在一个确切的时间，立即更改 AudioParam 的值。新的值由 value 参数给定。

AudioParam.linearRampToValueAtTime() (en-US)

调整 AudioParam 的值，使其逐渐按线性变化。这个变化会从上一个事件指定的事件开始，跟随一个线性变化到参数给定的新值，并在 endTime 参数给定的时间到达新值。

AudioParam.exponentialRampToValueAtTime() (en-US)

调整 AudioParam 的值，使其逐渐按指数变化。这个变化会从上一个事件指定的事件开始，跟随一个指数变化到参数给定的新值，并在 endTime 参数给定的时间到达新值。

AudioParam.setTargetAtTime() (en-US)

安排逐渐改变 AudioParam 的值的开始时间。这个变化将从 startTime 指定的时间开始，并且以指定的方式向目标参数给定的值改变。指数衰减速率由 timeConstant 参数定义，以秒为单位。

AudioParam.setValueCurveAtTime() (en-US)

调整 AudioParam 的值以跟随一组缩放到适应给定间隔的浮点数值，该间隔从给定的起始时间开始，持续一段给定的时长。

AudioParam.cancelScheduledValues() (en-US)

取消所有安排的对 AudioParam 的未来的改变。

AudioParam.cancelAndHoldAtTime() (en-US)

取消所有安排的对 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