AudioScheduledSourceNode: ended-Ereignis

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.

Das ended-Ereignis der AudioScheduledSourceNode-Schnittstelle wird ausgelöst, wenn der Quellknoten aufgehört hat zu spielen.

Dieses Ereignis tritt auf, wenn ein AudioScheduledSourceNode aufgehört hat zu spielen, entweder weil eine vorher festgelegte Stoppzeit erreicht wurde, die volle Dauer des Audios abgespielt wurde oder weil der gesamte Puffer abgespielt wurde.

Dieses Ereignis kann nicht abgebrochen werden und blubbert nicht.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.

js
addEventListener("ended", (event) => { })

onended = (event) => { }

Ereignistyp

Ein generisches Event.

Beispiele

In diesem einfachen Beispiel wird ein Ereignislistener für das ended-Ereignis eingerichtet, um eine "Start"-Schaltfläche in der Benutzeroberfläche zu aktivieren, wenn der Knoten aufhört zu spielen:

js
node.addEventListener("ended", () => {
  document.getElementById("startButton").disabled = false;
});

Sie können den Ereignishandler auch mit der onended-Eigenschaft einrichten:

js
node.onended = () => {
  document.getElementById("startButton").disabled = false;
};

Ein Beispiel für das verwendete ended-Ereignis finden Sie in unserem Beispiel mit Audio-Puffer auf GitHub.

Spezifikationen

Specification
Web Audio API
# dom-audioscheduledsourcenode-onended

Browser-Kompatibilität

BCD tables only load in the browser

Verwandte Ereignisse

Siehe auch