MediaStreamTrack: mute-Event
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 mute-Event wird an einen MediaStreamTrack gesendet, wenn die Quelle des Tracks vorübergehend nicht in der Lage ist, Mediendaten bereitzustellen.
Sobald der Track wieder in der Lage ist, Medienausgaben zu produzieren, wird ein unmute-Event gesendet.
In der Zeit zwischen dem mute-Event und dem unmute-Event ist der Wert der muted-Eigenschaft des Tracks true.
Hinweis:
Der Zustand, den die meisten Menschen als "stummgeschaltet" betrachten (d.h. ein benutzerbezogener Zustand, in dem ein Track stummgeschaltet wird), wird tatsächlich über die MediaStreamTrack.enabled-Eigenschaft verwaltet, für die es keine Events gibt.
Dieses Event kann nicht abgebrochen werden und wird nicht gebubbelt.
Syntax
Verwenden Sie den Eventnamen in Methoden wie addEventListener() oder setzen Sie eine Event-Handler-Eigenschaft.
addEventListener("mute", (event) => { })
onmute = (event) => { }
Event-Typ
Ein generisches Event.
Beispiele
In diesem Beispiel werden Event-Handler für die mute- und unmute-Events eingerichtet, um zu erkennen, wann die Medien nicht von der Quelle für den in musicTrack referenzierten MediaStreamTrack fließen.
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 Event-Handlern ändert sich die Hintergrundfarbe des Elements mit der ID timeline-widget zu #aaaaaa, wenn der Track musicTrack in seinen muted-Zustand eintritt. Wenn der Track den stummgeschalteten Zustand verlässt — erkannt durch das Eintreffen eines unmute-Events — wird die Hintergrundfarbe wieder auf Weiß gesetzt.
Sie können auch die onmute-Event-Handler-Eigenschaft verwenden, um einen Handler für dieses Event einzurichten; ebenso ist der onunmute-Event-Handler verfügbar, um einen Handler für das unmute-Event 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 über Receiver stummschalten
Das folgende Beispiel zeigt, wie man Tracks mit Receivern stummschaltet.
// Peer 1 (Receiver)
audioTrack.addEventListener("mute", (event) => {
// Do something in UI
});
videoTrack.addEventListener("mute", (event) => {
// Do something in UI
});
// Peer 2 (Sender)
const transceivers = peer.getTransceivers();
const audioTrack = transceivers[0];
audioTrack.direction = "recvonly";
const videoTrack = transceivers[1];
videoTrack.direction = "recvonly";
transceivers ist ein Array von RTCRtpTransceiver, in dem 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 # dom-mediastreamtrack-onmute |
Browser-Kompatibilität
Loading…