AudioScheduledSourceNode：start() 方法

基线 广泛可用

此功能已得到良好建立，并且可以在许多设备和浏览器版本中使用。它自以下时间以来在浏览器中可用 2021 年 4 月.

AudioScheduledSourceNode 上的 start() 方法计划在指定时间开始播放声音。如果未指定时间，则声音会立即开始播放。

语法

js
start()
start(when)

参数

when 可选

声音开始播放的时间（以秒为单位）。此值以与 AudioContext 用于其 currentTime 属性相同的时坐标系指定。值为 0（或完全省略 when 参数）会导致声音立即开始播放。

返回值

无 (undefined)。

异常

InvalidStateNode DOMException

如果节点已启动，则抛出此异常。即使节点由于先前对 stop() 的调用而不再运行，也会发生此错误。

RangeError

如果为 when 指定的值为负数，则抛出此异常。

示例

此示例演示如何创建一个 OscillatorNode，该节点计划在 2 秒后开始播放，并在 1 秒后停止播放。这些时间是通过将所需秒数添加到 AudioContext.currentTime 返回的上下文的当前时间戳来计算的。

js
context = new AudioContext();
osc = context.createOscillator();
osc.connect(context.destination);

/* Schedule the start and stop times for the oscillator */

osc.start(context.currentTime + 2);
osc.stop(context.currentTime + 3);

规范

规范
Web Audio API
# dom-audioscheduledsourcenode-start

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅