AudioScheduledSourceNode: ended-Ereignis
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.
Das ended-Ereignis der Schnittstelle AudioScheduledSourceNode wird ausgelöst, wenn der Quellknoten die Wiedergabe beendet hat.
Dies geschieht, wenn ein AudioScheduledSourceNode die Wiedergabe beendet hat – entweder weil ein vorab festgelegter Stoppzeitpunkt erreicht wurde, die gesamte Audiodauer abgespielt wurde oder der gesamte Buffer abgespielt wurde.
Dieses Ereignis kann nicht abgebrochen werden und wird nicht nach oben weitergereicht.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("ended", (event) => { })
Alternativ können Sie die Event-Handler-Eigenschaft der Schnittstelle zuweisen:
onended = (event) => { }
Ereignistyp
Ein generisches Event.
Beispiele
In diesem einfachen Beispiel wird ein Event-Listener für das ended-Ereignis eingerichtet, der eine „Start“-Schaltfläche in der Benutzeroberfläche aktiviert, sobald der Knoten die Wiedergabe beendet:
node.addEventListener("ended", () => {
document.getElementById("startButton").disabled = false;
});
Sie können den Event-Handler auch über die Eigenschaft onended einrichten. Beachten Sie jedoch, dass dadurch andere über onended hinzugefügte Event-Listener ersetzt werden, sofern vorhanden:
node.onended = () => {
document.getElementById("startButton").disabled = false;
};
Ein Anwendungsbeispiel für das ended-Ereignis finden Sie in unserem Audio-Buffer-Beispiel auf GitHub.
Spezifikationen
| Spezifikation |
|---|
| Web Audio API # dom-audioscheduledsourcenode-onended |
Browser-Kompatibilität
Verwandte Ereignisse
Siehe auch
HTMLAudioElementHTMLVideoElement<audio><video>- Das
ended-Ereignis von HTMLMediaElement - Das
ended-Ereignis von MediaStreamTrack