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

瀏覽器相容性

另見