MediaStreamTrack: mute 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 mute Ereignis wird an einen MediaStreamTrack gesendet, wenn die Quelle des Tracks vorübergehend nicht in der Lage ist, Mediendaten bereitzustellen.
Wenn der Track wieder in der Lage ist, Medien auszugeben, wird ein unmute Ereignis gesendet.
Während der Zeit zwischen dem mute Ereignis und dem unmute Ereignis ist der Wert der muted Eigenschaft des Tracks true.
Hinweis:
Der Zustand, den die meisten Menschen als "stummgeschaltet" betrachten (d.h. ein vom Benutzer umgeschalteter Zustand zum Stummschalten eines Tracks), wird tatsächlich mithilfe der MediaStreamTrack.enabled Eigenschaft verwaltet, für die es keine Ereignisse gibt.
Dieses Ereignis ist nicht abbruchfähig und wird nicht weitergeleitet.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Event-Handler-Eigenschaft.
addEventListener("mute", (event) => { })
onmute = (event) => { }
Ereignistyp
Ein generisches Event.
Beispiele
In diesem Beispiel werden Event-Handler für die mute und unmute Ereignisse eingerichtet, um zu erkennen, wann die Medienquelle für den MediaStreamTrack, auf den musicTrack verweist, nicht fließt.
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 Event-Handlern wird, wenn der Track musicTrack in seinen muted Zustand eintritt, das Hintergrundfarbelement mit der ID timeline-widget auf #aaaaaa geändert. Wenn der Track den stummgeschalteten Zustand verlässt—erkennbar durch das Eintreffen eines unmute Ereignisses—wird die Hintergrundfarbe wieder auf Weiß zurückgesetzt.
Sie können auch die onmute Event-Handler-Eigenschaft verwenden, um einen Handler für dieses Ereignis einzurichten; ähnlich ist die onunmute Event-Handler-Eigenschaft verfügbar, um einen Handler für das unmute 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 über Empfänger stummschalten
Das folgende Beispiel zeigt, wie Tracks mit Hilfe von Empfängern stummgeschaltet werden.
// Peer 1 (Sender)
const transceivers = peer.getTransceivers();
const audioTrack = transceivers[0];
audioTrack.direction = "recvonly";
const videoTrack = transceivers[1];
videoTrack.direction = "recvonly";
// Peer 2 (Receiver)
audioTrack.addEventListener("mute", (event) => {
// Do something in UI
});
videoTrack.addEventListener("mute", (event) => {
// Do something in UI
});
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…