AudioScheduledSourceNode: start()-Methode

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.

Die start()-Methode auf einem AudioScheduledSourceNode plant die Wiedergabe eines Sounds zu der angegebenen Zeit zu beginnen. Wenn keine Zeit angegeben ist, beginnt der Sound sofort mit der Wiedergabe.

Syntax

js
start()
start(when)

Parameter

when Optional

Die Zeit, in Sekunden, zu der der Sound beginnen soll zu spielen. Dieser Wert wird im gleichen Zeitkoordinatensystem angegeben, das auch der AudioContext für sein currentTime-Attribut verwendet. Ein Wert von 0 (oder das vollständige Weglassen des when-Parameters) führt dazu, dass der Sound sofort mit der Wiedergabe beginnt.

Rückgabewert

Keiner (undefined).

Ausnahmen

InvalidStateNode DOMException

Wird ausgelöst, wenn der Node bereits gestartet wurde. Dieser Fehler tritt auch auf, wenn der Node aufgrund eines vorherigen Aufrufs von stop() nicht mehr läuft.

RangeError

Wird ausgelöst, wenn der für when angegebene Wert negativ ist.

Beispiele

Dieses Beispiel zeigt, wie ein OscillatorNode erstellt wird, der so geplant ist, dass er in 2 Sekunden zu spielen beginnt und 1 Sekunde danach aufhört zu spielen. Die Zeiten werden berechnet, indem die gewünschte Anzahl Sekunden zum aktuellen Zeitstempel des Kontextes hinzugefügt wird, der von AudioContext.currentTime zurückgegeben wird.

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);

Spezifikationen

Specification
Web Audio API
# dom-audioscheduledsourcenode-start

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch