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 March 2018.

Das unmute Ereignis wird an ein MediaStreamTrack gesendet, wenn die Quelle des Tracks nach einer Phase der Unfähigkeit, Mediendaten bereitzustellen, wieder in der Lage ist, diese zu liefern.

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

Hinweis: Der Zustand, den die meisten Menschen als "stummgeschaltet" empfinden (also eine benutzerkontrollierbare Möglichkeit, einen Track stummzuschalten), wird tatsächlich mithilfe der MediaStreamTrack.enabled Eigenschaft verwaltet, für die es keine Ereignisse gibt.

Dieses Ereignis ist nicht abbrechbar und wird nicht gebubbelt.

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 die Medienquelle des MediaStreamTrack, das in der Variable musicTrack gespeichert ist, keine Daten liefert.

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

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

Mit diesen Ereignishandlern wird, wenn der Track musicTrack in seinen muted Zustand übergeht, das Hintergrundfarbe des Elements mit der ID timeline-widget auf #aaa geändert. Wenn der Track den stummgeschalteten Zustand verlässt—erkannt durch das Eintreffen eines unmute 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 steht der onmute Ereignishandler zum Einrichten eines Handlers für das mute Ereignis zur Verfügung. Das folgende Beispiel zeigt dies:

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

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

Tracks über Empfänger wieder aktivieren

Das folgende Beispiel zeigt, wie Tracks über Empfänger wieder aktiviert 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 die gesendete und empfangene Audio- oder Videospur 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