MediaStreamTrack: 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 September 2017.

Das ended Ereignis der MediaStreamTrack Schnittstelle wird ausgelöst, wenn die Wiedergabe oder das Streaming gestoppt wurde, da das Ende der Medien erreicht wurde oder keine weiteren Daten verfügbar sind.

Dieses Ereignis ist nicht abbruchfähig und wird nicht weitergeleitet.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener(), oder setzen Sie eine Ereignishandlereigenschaft.

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

onended = (event) => { }

Ereignistyp

Ein generisches Event.

Verwendungshinweise

ended-Ereignisse werden ausgelöst, wenn die Quelle der Mediastream-Spur dauerhaft aufhört, Daten im Stream zu senden. Es gibt verschiedene Möglichkeiten, wie dies geschehen kann, darunter:

  • Es sind keine Daten mehr zum Senden vorhanden.
  • Der Benutzer hat die erforderlichen Berechtigungen für das Senden der Daten widerrufen.
  • Die Hardware, die die Quelldaten generiert, wurde entfernt oder ausgeworfen.
  • Ein entfernter Teilnehmer hat dauerhaft aufgehört, Daten zu senden.
  • Der einzige Fall, in dem die Spur endet, das ended-Ereignis jedoch nicht ausgelöst wird, ist beim Aufruf von MediaStreamTrack.stop.

Das Pausieren von Medien erzeugt kein ended-Ereignis.

Beispiele

Dieses Beispiel richtet einen Ereignishandler für das ended-Ereignis ein, der ein Symbol auf dem Bildschirm ändert, um anzuzeigen, dass die Spur nicht mehr aktiv ist.

js
track.addEventListener("ended", () => {
  let statusElem = document.getElementById("status-icon");
  statusElem.src = "/images/stopped-icon.png";
});

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

js
track.onended = () => {
  let statusElem = document.getElementById("status-icon");

  statusElem.src = "/images/stopped-icon.png";
};

Spezifikationen

Specification
Media Capture and Streams
# dom-mediastreamtrack-onended

Browser-Kompatibilität

Siehe auch