AudioScheduledSourceNode: start() メソッド

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.

start() は AudioScheduledSourceNode のメソッドで、指定した時刻に再生が始まるように、音をスケジュールします。 時刻を指定しなかった場合は、すぐに音を再生し始めます。

構文

js
start()
start(when)

引数

when 省略可

音の再生を始めるべき時刻を、秒単位で指定します。この値は AudioContext がその currentTime 属性で使用しているのと同じ時間座標系で指定します。0 の値を指定する（または when 引数を完全に除外する）と、音の再生をすぐに始めるようにします。

返値

なし (undefined)。

例外

InvalidStateNode DOMException

ノードが既に開始されている場合に発生します。このエラーは stop() を事前に呼び出したためにノードがもう実行されていない場合でも発生します。

RangeError

when に指定した値が負である場合に発生します。

例

この例では、2 秒後に再生を始め、その1秒後に再生を停止するようにスケジュールされた OscillatorNode を作成する方法を示します。時刻は AudioContext.currentTime が返すコンテキストの現在のタイムスタンプに希望の秒数を加えることで計算されます。

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

/* 発振器の開始時刻と停止時刻を設定する。 */

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

仕様書

Specification
Web Audio API
# dom-audioscheduledsourcenode-start

ブラウザーの互換性

BCD tables only load in the browser

関連情報