The unmute
event is sent to a MediaStreamTrack
when the track's source is once again able to provide media data after a period of not being able to do so. This ends the muted
state that began with the mute
event.
Bubbles | No |
Cancelable | No |
Interface | Event
|
Event handler property | onunmute
|
Note: The condition that most people think of as "muted" (that is, a user-controllable way to silence a track) is actually managed using the MediaStreamTrack.enabled
property, for which there are no events.
Examples
In this example, event handlers are established for the mute
and unmute
events in order to detect when the media is not flowing from the source for the MediaStreamTrack
stored in the variable musicTrack
.
musicTrack.addEventListener("mute", event => {
document.getElementById("timeline-widget").style.backgroundColor = "#aaa";
}, false);
musicTrack.addEventListener("unmute", event => {
document.getElementById("timeline-widget").style.backgroundColor = "#fff";
}, false);
With these event handlers in place, when the track musicTrack
enters its muted
state, the element with the ID timeline-widget
gets its background color changed to #aaa
. When the track exits the muted state—detected by the arrival of an unmuted
event—the background color is restored to white.
You can also use the onunmute
event handler property to set up a handler for this event; similarly, the onmute
event handler is available for setting up a handler for the mute
event. The following example shows this:
musicTrack.onmute = event => {
document.getElementById("timeline-widget").style.backgroundColor = "#aaa";
}
musicTrack.mute = event = > {
document.getElementById("timeline-widget").style.backgroundColor = "#fff";
}
Specifications
Specification | Status | Comment |
---|---|---|
Media Capture and StreamsThe definition of 'unmute' in that specification. | Candidate Recommendation | Initial specification. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
unmute event
|
Chrome
Full support Yes |
Edge
Full support 12 |
Firefox
Full support 59 |
IE
No support No |
Opera
Full support Yes |
Safari
Full support Yes |
WebView Android
Full support Yes |
Chrome Android
Full support Yes |
Firefox Android
Full support 59 |
Opera Android
Full support Yes |
Safari iOS
Full support Yes |
Samsung Internet Android
Full support Yes |
Legend
- Full support
- Full support
- No support
- No support
See also
MediaStreamTrack: unmute event by Mozilla Contributors is licensed under CC-BY-SA 2.5.