MediaStreamTrack.enabled 属性用于实时启用或禁用单个音视频轨道，设为 false 可立即静音或停显，不终止采集且响应迅速；它仅影响对应轨道的数据编码与传输，不影响整个 MediaStream。
MediaStreamTrack.enabled 属性是控制音视频轨道是否启用的核心开关，设为 false 即刻静音（音频）或停用画面（视频），无需重新获取流或重建连接，响应极快。
理解 enabled 属性的作用范围
该属性作用于单个轨道（如麦克风音频轨、摄像头视频轨），不影响整个 MediaStream。它不终止采集，仅决定该轨道数据是否参与编码和传输——关闭后浏览器停止向远端发送该轨数据，本地预览也可同步静音/黑屏（取决于渲染逻辑）。
- 音频轨设为 false：立即无声音输出，远端听不到，本地
<audio>或MediaRecorder也收不到音频数据 - 视频轨设为 false：画面冻结或变黑（取决于浏览器实现），远端收不到新帧，但摄像头物理仍在工作
- 属性可随时读写，修改后几乎无延迟生效，适合按钮点击式切换
获取并操作目标轨道
从 getUserMedia 获取的 stream 中遍历 getAudioTracks() 或 getVideoTracks()，找到需控制的轨道。通常首条即主设备轨：
let stream;
navigator.mediaDevices.getUserMedia({ audio: true, video: true })
.then(s => {
stream = s;
const audioTrack = stream.getAudioTracks()[0];
const videoTrack = stream.getVideoTracks()[0];
// 静音音频
audioTrack.enabled = false;
// 关闭视频
videoTrack.enabled = false;
});
封装成可复用的切换函数
避免重复查找轨道，建议缓存引用，并提供统一 toggle 接口：
立即学习“前端免费学习笔记（深入）”；
class MediaController {
constructor(stream) {
this.audioTrack = stream.getAudioTracks()[0];
this.videoTrack = stream.getVideoTracks()[0];
}
toggleAudio() {
if (this.audioTrack) {
this.audioTrack.enabled = !this.audioTrack.enabled;
return this.audioTrack.enabled;
}
}
toggleVideo() {
if (this.videoTrack) {
this.videoTrack.enabled = !this.videoTrack.enabled;
return this.videoTrack.enabled;
}
}
}
// 使用示例
const controller = new MediaController(stream);
document.getElementById('muteBtn').onclick = () => {
const isUnmuted = controller.toggleAudio();
document.getElementById('muteBtn').textContent = isUnmuted ? '静音' : '取消静音';
};
注意事项与兼容性
虽为标准属性，但需注意实际行为细节：
- 部分旧版 Safari 对
enabled切换视频轨响应稍慢，可配合track.stop()强制释放（但 stop 后不可恢复，慎用） - 调用
enabled = false不触发onmute事件，如需监听状态变化，应自行维护开关状态并派发自定义事件 - 若使用 WebRTC，PeerConnection 会自动感知轨道启停，远端
track.onmute可收到通知（需对方支持） - 桌面端 Chrome/Firefox、iOS 15+/Android Chrome 均稳定支持，无需前缀
