AudioParam: cancelScheduledValues() 方法

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

AudioParam 接口的 cancelScheduledValues() 方法可以取消 AudioParam 的所有已计划的未来更改。

语法

js
cancelScheduledValues(startTime)

参数

startTime

一个双精度浮点数,表示自 AudioContext 首次创建后经过的时间(以秒为单位),在该时间点之后的所有计划的更改都将被取消。

返回值

对该 AudioParam 对象的引用。在某些旧的实现中,此方法返回 undefined

示例

js
const gainNode = audioCtx.createGain();
gainNode.gain.setValueCurveAtTime(waveArray, audioCtx.currentTime, 2); // 'gain' is the AudioParam
gainNode.gain.cancelScheduledValues(audioCtx.currentTime);

规范

规范
Web Audio API
# dom-audioparam-cancelscheduledvalues

浏览器兼容性

另见