Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 einen MediaStreamTrack gesendet, wenn die Quelle des Tracks nach einer Zeitspanne, in der sie keine Mediendaten bereitstellen konnte, wieder in der Lage ist, Mediendaten zu liefern.

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

Hinweis: Der Zustand, den die meisten Menschen als "stumm" betrachten (das heißt, eine vom Benutzer kontrollierbare Möglichkeit, einen Track stummzuschalten), wird tatsächlich über die MediaStreamTrack.enabled Eigenschaft verwaltet, für die es keine Ereignisse gibt.

Dieses Ereignis ist nicht abbrichbar und wird nicht gebubbelt.

Syntax

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

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

onunmute = (event) => { }

Ereignistyp

Ein generisches Event.

Beispiele

In diesem Beispiel werden Ereignis-Handler für die mute und unmute Ereignisse eingerichtet, um zu erkennen, wann die Medien von der Quelle für den MediaStreamTrack, die in der Variablen musicTrack gespeichert ist, nicht fließen.

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

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

Mit diesen Ereignis-Handlern wird, wenn der Track musicTrack in seinen muted Zustand wechselt, das Hintergrundfarbelement mit der ID timeline-widget auf #aaaaaa geändert. Wenn der Track den stummgeschalteten Zustand verlässt – was durch das Eintreffen eines unmuted Ereignisses erkannt wird – wird die Hintergrundfarbe wieder auf Weiß zurückgesetzt.

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

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

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

Tracks über Receiver freischalten

Das folgende Beispiel zeigt, wie man Tracks mit Receivern freischalten kann.

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

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

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

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

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

transceivers ist ein Array von RTCRtpTransceiver, wo Sie den gesendeten und empfangenen Audio- oder Video-Track finden können. Für weitere Informationen siehe den Artikel über direction.

Spezifikationen

Specification
Media Capture and Streams
# event-mediastreamtrack-unmute

Browser-Kompatibilität

Siehe auch