AudioScheduledSourceNode.stop()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.
AudioScheduledSourceNode
上的stop()
方法将声音安排在指定的时间停止播放。如果没有指定时间,声音将立即停止播放。
每次在同一个节点上调用 stop()
时,指定的时间将替换任何未发生的计划停止时间。如果节点已经停止,则此方法无效。
备注:如果计划的停止时间发生在节点计划的开始时间之前,则节点永远不会开始运行。
语法
stop()
stop(when)
参数
when
可选-
声音停止播放的时间,单位为秒。这个值在
AudioContext
用于其currentTime
属性的同一时间坐标系统中指定。省略这个参数,设置为 0 或者负值都会立即停止播放。
Return value
Exceptions
InvalidStateNode
-
节点还没有通过调用
start()
方法被播放。 RangeError
-
当
when
指定为负值时。
Example
This example demonstrates starting an oscillator node, scheduled to begin playing at once and to stop playing in one second. The stop time is determined by taking the audio context's current time from AudioContext.currentTime
and adding 1 second.
context = new AudioContext();
osc = context.createOscillator();
osc.connect(context.destination);
/* Let's play a sine wave for one second. */
osc.start();
osc.stop(context.currentTime + 1);
Specifications
Specification |
---|
Web Audio API # dom-audioscheduledsourcenode-stop |
Browser compatibility
BCD tables only load in the browser