MediaStreamTrack: unmute Ereignis

Das unmute Ereignis wird an ein MediaStreamTrack gesendet, wenn die Quelle des Tracks nach einer Periode, in der sie keine Mediendaten liefern konnte, wieder in der Lage ist, diese bereitzustellen.

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

Hinweis: Die Bedingung, die die meisten Menschen als "stummgeschaltet" betrachten (also eine benutzerkontrollierbare 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 Ereignisblase aus.

Syntax

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

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

onunmute = (event) => {};

Ereignistyp

Ein generisches Event.

Beispiele

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

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 Ereignisbehandlern wechselt das Element mit der ID timeline-widget seine Hintergrundfarbe zu #aaa, wenn der Track musicTrack seinen muted Zustand erreicht. Wenn der Track den stummgeschalteten Zustand verlässt—erkannt durch das Eintreffen eines unmuted Ereignisses—wird die Hintergrundfarbe auf Weiß zurückgesetzt.

Sie können auch die onunmute Ereignisbehandlereigenschaft verwenden, um einen Behandler für dieses Ereignis einzurichten; ähnlich steht die onmute Ereignisbehandlereigenschaft zur Verfügung, um einen Behandler für das mute Ereignis einzurichten. 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 Receiver unmute

Das folgende Beispiel zeigt, wie Sie Tracks mithilfe von Receivern unmute.

// 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 gesendeten und empfangenen Audio- oder Videospuren finden können. Weitere Informationen finden Sie im direction Artikel.

Spezifikationen

Specification
Media Capture and Streams # event-mediastreamtrack-unmute

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

Das mute Ereignis