MediaStreamTrack: unmute Ereignis

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨März 2018⁩.

Das unmute Ereignis wird an ein MediaStreamTrack gesendet, wenn die Quelle des Tracks nach einer Periode, in der kein Mediendaten bereitgestellt werden konnten, wieder in der Lage ist, Mediendaten bereitzustellen.

Dies beendet den muted Zustand, der mit dem mute Ereignis begann.

Hinweis: Die Bedingung, die die meisten Menschen als "stummgeschaltet" betrachten (d.h. eine benutzerkontrollierte Möglichkeit, einen Track stummzuschalten), wird tatsächlich über die MediaStreamTrack.enabled Eigenschaft verwaltet, für die es keine Ereignisse gibt.

Dieses Ereignis kann nicht abgebrochen werden und löst keine Bubbling aus.

Syntax

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

addEventListener("unmute", (event) => { })

onunmute = (event) => { }

Ereignistyp

Ein generisches Event.

Beispiele

In diesem Beispiel werden Ereignishandler für die mute und unmute Ereignisse eingerichtet, um zu erkennen, wann das Medium nicht von der Quelle für das MediaStreamTrack, das in der Variable musicTrack gespeichert ist, fließt.

musicTrack.addEventListener(
  "mute",
  (event) => {
    const widget = document.getElementById("timeline-widget");
    widget.style.backgroundColor = "#aaaaaa";
  },
  false,
);

musicTrack.addEventListener(
  "unmute",
  (event) => {
    document.getElementById("timeline-widget").style.backgroundColor = "white";
  },
  false,
);

Mit diesen Ereignishandlern wird, wenn der Track musicTrack in seinen muted Zustand wechselt, die Hintergrundfarbe des Elements mit der ID timeline-widget auf #aaaaaa geändert. Wenn der Track den stummgeschalteten Zustand verlässt – erkannt am Eintreffen eines unmuted Ereignisses – wird die Hintergrundfarbe auf weiß zurückgesetzt.

Sie können auch die onunmute Ereignishandler-Eigenschaft verwenden, um einen Handler für dieses Ereignis einzurichten; ähnlich ist der onmute Ereignishandler verfügbar, um einen Handler für das mute Ereignis einzurichten. Das folgende Beispiel zeigt dies:

musicTrack.onmute = (event) => {
  document.getElementById("timeline-widget").style.backgroundColor = "#aaaaaa";
};

musicTrack.onunmute = (event) => {
  document.getElementById("timeline-widget").style.backgroundColor = "white";
};

Tracks durch Empfänger unmutieren

Das folgende Beispiel zeigt, wie Tracks durch Empfänger unmutiert werden.

// Peer 1 (Receiver)
audioTrack.addEventListener("unmute", (event) => {
  // Do something in UI
});

videoTrack.addEventListener("unmute", (event) => {
  // Do something in UI
});

// Peer 2 (Sender)
const transceivers = peer.getTransceivers();

const audioTrack = transceivers[0];
audioTrack.direction = "sendrecv";

const videoTrack = transceivers[1];
videoTrack.direction = "sendrecv";

transceivers ist ein Array von RTCRtpTransceiver, in dem Sie den gesendeten und empfangenen Audio- oder Videotrack finden können. Weitere Informationen finden Sie im Artikel über direction.

Spezifikationen

Specification
Media Capture and Streams # event-mediastreamtrack-unmute

Browser-Kompatibilität

Siehe auch

Das mute Ereignis

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden