AudioScheduledSourceNode: Methode stop()
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.
Die Methode stop() von AudioScheduledSourceNode legt fest, wann die Wiedergabe eines Tons endet. Wird kein Zeitpunkt angegeben, endet die Wiedergabe sofort.
Wenn Sie stop() erneut für denselben Node aufrufen, ersetzt der angegebene Zeitpunkt einen zuvor festgelegten Stoppzeitpunkt, sofern dieser noch nicht erreicht wurde. Wenn der Node bereits gestoppt wurde, hat die Methode keine Wirkung.
Hinweis: Liegt der geplante Stoppzeitpunkt vor dem geplanten Startzeitpunkt des Nodes, beginnt die Wiedergabe nie.
Syntax
stop()
stop(when)
Parameter
whenOptional-
Der Zeitpunkt in Sekunden, zu dem die Wiedergabe des Tons enden soll. Dieser Wert wird im selben Zeitkoordinatensystem angegeben, das
AudioContextfür sein AttributcurrentTimeverwendet. Wenn Sie diesen Parameter weglassen oder den Wert 0 angeben, endet die Wiedergabe sofort.
Rückgabewert
Keiner (undefined).
Ausnahmen
InvalidStateErrorDOMException-
Wird ausgelöst, wenn der Node noch nicht durch einen Aufruf von
start()gestartet wurde. RangeError-
Wird ausgelöst, wenn der für
whenangegebene Wert negativ ist.
Beispiele
Dieses Beispiel zeigt, wie ein Oszillator-Node gestartet wird, der sofort mit der Wiedergabe beginnt und nach einer Sekunde stoppt. Der Stoppzeitpunkt wird berechnet, indem zum aktuellen Zeitpunkt des Audio-Kontexts aus AudioContext.currentTime eine Sekunde addiert wird.
context = new AudioContext();
osc = context.createOscillator();
osc.connect(context.destination);
/* Let's play a sine wave for one second. */
osc.start();
osc.stop(context.currentTime + 1);
Spezifikationen
| Spezifikation |
|---|
| Web Audio API # dom-audioscheduledsourcenode-stop |