The start()
method of the AudioBufferSourceNode
Interface is used to schedule the start of the audio buffer playback.
Syntax
var source = audioCtx.createBufferSource();
source.start(audioCtx.currentTime + 1,3,10);
Examples
The most simple example just starts the audio buffer playing from the beginning — you don't need to specify any parameters in this case:
source.start();
The following more complex example will start playing, after 1 second pause, a 10 second snippet of an audio buffer 3 seconds into the audio duration.
source.start(audioCtx.currentTime + 1,3,10);
Note: For a more complete example showing start()
in use, check out our AudioContext.decodeAudioData
example, You can also run the code example live, or view the source.
Returns
Void.
Parameters
- when
- The
when
parameter defines when the play will start. Ifwhen
represents a time in the past, the play will start immediately. If the method is called more than one time, or after a call toAudioBufferSourceNode.stop()
, an exception is raised. - offset
- The
offset
parameter, which defaults to0
, defines where the playback will start. - duration
- The
duration
parameter, which defaults to the length of the asset minus the value ofoffset
, defines the length of the portion of the asset to be played.
Specification
Specification | Status | Comment |
---|---|---|
Web Audio API The definition of 'start()' in that specification. |
Working Draft |