AudioScheduledSourceNode: Methode start()

Baseline

Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2020 browserübergreifend verfügbar.

Vollständige Kompatibilität anzeigen
Mehr erfahren

Die Methode start() von AudioScheduledSourceNode legt fest, wann die Wiedergabe eines Tons beginnt. Wenn kein Zeitpunkt angegeben wird, beginnt die Wiedergabe sofort.

Syntax

start()
start(when)

Parameter

when Optional: Der Zeitpunkt in Sekunden, zu dem die Wiedergabe des Tons beginnen soll. Dieser Wert verwendet dasselbe Zeitkoordinatensystem wie das Attribut currentTime des AudioContext. Ein Wert von 0 (oder das vollständige Weglassen des Parameters when) bewirkt, dass die Wiedergabe sofort beginnt.

Ausnahmen

InvalidStateError DOMException: Wird ausgelöst, wenn der Node bereits gestartet wurde. Dieser Fehler tritt auch dann 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.

Dieses Beispiel zeigt, wie ein OscillatorNode erstellt wird, dessen Wiedergabe nach 2 Sekunden beginnt und 1 Sekunde später endet. Die Zeitpunkte werden berechnet, indem die gewünschte Anzahl an Sekunden zum aktuellen Zeitwert des Kontexts addiert wird, den AudioContext.currentTime zurückgibt.

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