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