MediaStreamTrack: ended Ereignis

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

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

Syntax

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

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

onended = (event) => {};

Ereignistyp

Ein generisches Event.

Verwendungshinweise

ended Ereignisse werden ausgelöst, wenn die Quelle des Medienstream-Tracks dauerhaft aufhört, Daten zu senden. Es gibt verschiedene Möglichkeiten, wie dies geschehen kann, darunter:

  • Es sind keine weiteren Daten mehr zum Senden vorhanden.
  • Der Benutzer hat die für das Senden notwendigen Berechtigungen widerrufen.
  • Die Hardware, die die Quelldaten erzeugt, wurde entfernt oder ausgeworfen.
  • Ein Remote-Peer hat dauerhaft aufgehört, Daten zu senden.
  • Der einzige Fall, in dem der Track endet, aber das ended Ereignis nicht ausgelöst wird, ist, wenn MediaStreamTrack.stop aufgerufen wird.

Das Pausieren von Medien erzeugt kein ended Ereignis.

Beispiele

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

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

Sie können den Ereignis-Handler auch über die 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

BCD tables only load in the browser

Siehe auch