MediaStreamTrack: unmute-Ereignis
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2018 browserübergreifend verfügbar.
Das unmute-Ereignis wird an einen MediaStreamTrack gesendet, wenn die Quelle des Tracks nach einer Unterbrechung wieder Mediendaten bereitstellen kann.
Damit endet der Zustand muted, der mit dem Ereignis mute begonnen hat.
Hinweis:
Was die meisten Menschen unter „stummgeschaltet“ verstehen – also eine vom Benutzer steuerbare Möglichkeit, einen Track stummzuschalten –, wird tatsächlich über die Eigenschaft MediaStreamTrack.enabled gesteuert. Für Änderungen dieser Eigenschaft gibt es keine Ereignisse.
Dieses Ereignis kann nicht abgebrochen werden und wird nicht nach oben weitergegeben.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("unmute", (event) => { })
Alternativ können Sie der Event-Handler-Eigenschaft der Schnittstelle einen Wert zuweisen:
onunmute = (event) => { }
Ereignistyp
Ein generisches Event.
Beispiele
In diesem Beispiel werden Event-Handler für die Ereignisse mute und unmute eingerichtet. So lässt sich erkennen, wann von der Quelle des in der Variablen musicTrack gespeicherten MediaStreamTrack keine Mediendaten übertragen werden.
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 die Hintergrundfarbe des Elements mit der ID timeline-widget auf #aaaaaa gesetzt, wenn der Track musicTrack in den Zustand muted wechselt. Verlässt der Track diesen Zustand – erkennbar am Eintreffen eines unmuted-Ereignisses –, wird die Hintergrundfarbe wieder auf Weiß gesetzt.
Sie können auch die Event-Handler-Eigenschaft onunmute verwenden, um einen Handler für dieses Ereignis einzurichten. Entsprechend steht der Event-Handler onmute für das Ereignis mute zur Verfügung. Das folgende Beispiel zeigt dies. Beachten Sie jedoch, dass dadurch gegebenenfalls andere über onmute und onunmute hinzugefügte Event-Listener ersetzt werden:
musicTrack.onmute = (event) => {
document.getElementById("timeline-widget").style.backgroundColor = "#aaaaaa";
};
musicTrack.onunmute = (event) => {
document.getElementById("timeline-widget").style.backgroundColor = "white";
};
Stummschaltung von Tracks über Receiver aufheben
Das folgende Beispiel zeigt, wie Sie die Stummschaltung von Tracks mithilfe von Receivern aufheben.
// 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-Objekten, über das Sie die gesendeten und empfangenen Audio- oder Videotracks ermitteln können. Weitere Informationen finden Sie im Artikel zur Eigenschaft direction.
Spezifikationen
| Spezifikation |
|---|
| Media Capture and Streams # event-mediastreamtrack-unmute |
Browser-Kompatibilität
Siehe auch
- Das Ereignis
mute