大网数据广告活动
Web 标准与前端开发

MediaStreamTrack: enabled property

· 52CE 我爱测

The **`enabled`** property of the MediaStreamTrack interface is a Boolean value which is `true` if the track is allowed to render the source stream or `false` if it is not. This can be used to intentionally mute a track.

Media Capture and Streams

The enabled property of the MediaStreamTrack interface is a Boolean value which is true if the track is allowed to render the source stream or false if it is not. This can be used to intentionally mute a track.

When enabled, a track's data is output from the source to the destination; otherwise, empty frames are output.

In the case of audio, a disabled track generates frames of silence (that is, frames in which every sample's value is 0). For video tracks, every frame is filled entirely with black pixels.

The value of enabled, in essence, represents what a typical user would consider the muting state for a track, whereas the MediaStreamTrack.muted property indicates a state in which the track is temporarily unable to output data, such as a scenario in which frames have been lost in transit.

[!NOTE] If the track has been disconnected, the value of this property can be changed, but has no effect.

Value

When true, enabled indicates that the track is permitted to render its actual media to the output. When enabled is set to false, the track only generates empty frames.

Empty audio frames have every sample's value set to 0. Empty video frames have every pixel set to black.

[!NOTE] When implementing a mute/unmute feature, you should use the enabled property.

Usage notes

If the MediaStreamTrack represents the video input from a camera, disabling the track by setting enabled to false also updates device activity indicators to show that the camera is not currently recording or streaming. For example, the green "in use" light next to the camera in iMac and MacBook computers turns off while the track is muted in this way.

Example

This example demonstrates a Element/click_event event handler for a pause button.

pauseButton.onclick = (evt) => {
  const newState = !myAudioTrack.enabled;

  pauseButton.innerHTML = newState ? "▶️" : "⏸️";
  myAudioTrack.enabled = newState;
};

This creates a variable, newState, which is the opposite of the current value of enabled, then uses that to select either the Emoji character for the "play" icon or the character for the "pause" icon as the new Element.innerHTML of the pause button's element.

Finally, the new value of enabled is saved, making the change take effect.

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。