AudioScheduledSourceNode: start() メソッド

構文

start()
start(when)

引数

when 省略可

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

返値

なし (undefined)。

例外

InvalidStateNode DOMException

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

RangeError

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

例

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

context = new AudioContext();
osc = context.createOscillator();
osc.connect(context.destination);
/* 発振器の開始時刻と停止時刻を設定する。 */
osc.start(context.currentTime + 2);
osc.stop(context.currentTime + 3);

仕様書

ブラウザーの互換性

関連情報

• ウェブオーディオ API の使用
• stop()
• AudioScheduledSourceNode
• AudioBufferSourceNode
• ConstantSourceNode
• OscillatorNode