AudioParam

AudioParam 接口代表音频相关的参数,通常是一个 AudioNode (例如 GainNode.gain) 的参数。一个 AudioParam 可以被设置为一个具体的值或者数值的改变,可以被安排在在一个具体的时刻并且遵循一个特定的模式发生。

下面有两种类型的 AudioParam, a-ratek-rate 参数:

  • 一个 a-rate AudioParam 获取音频信号的每个采样帧的当前音频参数值。
  • 一个 k-rate AudioParam 对于待处理的整个块使用相同的初始音频参数值,即 128 个采样帧。

每个 AudioNode 定义了其规格中哪一个参数是 a-ratek-rate

每个 AudioParam 有一个事件的列表,初始化时列表为空。该列表定义了什么时候数值怎么改变。当这个列表不是空的时候,使用 AudioParam.value 属性的改变会被忽略。事件的列表允许我们去有计划地进行必须在非常精确的时间发生的更改,使用任意的基于时间轴的自动化曲线。被使用的时间在AudioContext.currentTime 中被定义。

属性

AudioParam 继承的属性来自于它的父类, AudioNode

AudioParam.defaultValue (en-US) 只读

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

AudioParam.maxValue (en-US) 只读

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

AudioParam.minValue (en-US) 只读

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

AudioParam.value (en-US)

代表参数的浮点数音量值;初始化设定为 AudioParam.defaultValue 的值。虽然它可以被设置,但是任何发生在自动化事件(事件被计划用于 AudioParam)的修改会被忽略,没有任何例外。

方法

AudioParam 初始化的方法来自它的父类,AudioNode.

AudioParam.setValueAtTime() (en-US)

在一个确切的时间,即时更改 AudioParam 的值,按照AudioContext.currentTime 的时间。新的值会被传递到 value 参数。

AudioParam.linearRampToValueAtTime() (en-US)

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

AudioParam.exponentialRampToValueAtTime() (en-US)

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

AudioParam.setTargetAtTime() (en-US)

将开始计划改变 AudioParam 的值。这个改变将从 startTime 指定的时间开始,并且以指定的方式向目标参数给定的值改变。指数衰减速率由 timeConstant 参数定义,time 参数使以秒作为测量单位的时间。

AudioParam.setValueCurveAtTime() (en-US)

调整 AudioParam 的值以跟随一组定义为 Float32Array (en-US) 的值,数值会缩放到适应给定的间隔,从 startTime 时间开始并具有特定的持续时间(duration)。

AudioParam.cancelScheduledValues() (en-US)

取消全部在 AudioParam 中的未来计划发生的改变。

AudioParam.cancelAndHoldAtTime() (en-US)

取消全部计划将来对 AudioParam 的改变,但是保持给定时间的值,直到将来的使用其他方法产生改变。新的值会被赋予到 value 属性中。

例子

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

var AudioContext = window.AudioContext || window.webkitAudioContext;
var audioCtx = new AudioContext();

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

另外,一个例子展示了 BiquadFilterNode 拥有的一些值。这是一个 k-rate AudioParam 的例子,因为一次为整个音频块设置的值。

var AudioContext = window.AudioContext || window.webkitAudioContext;
var audioCtx = new AudioContext();

var biquadFilter = audioCtx.createBiquadFilter();

biquadFilter.type = "lowshelf";
biquadFilter.frequency.value = 1000;
biquadFilter.gain.value = 25;

标准

Specification
Web Audio API
# AudioParam

浏览器兼容性

BCD tables only load in the browser

See also