必须在安全上下文(HTTPS或localhost)下调用navigator.mediaDevices.getUserMedia({video:true,audio:true})获取流;开关音视频需操作track.enabled而非重调API;iOS Safari要求用户手势触发且权限限制严格。

如何用 navigator.mediaDevices.getUserMedia() 获取摄像头和麦克风流
这是控制媒体流的起点,必须先调用它才能拿到 MediaStream 对象。注意:该 API 只在安全上下文(https 或 localhost)中可用,HTTP 页面会直接拒绝。
常见错误是传入空对象或错误结构的约束对象,导致只拿到音频、或报 NotAllowedError / NotFoundError:
- 想同时启用摄像头和麦克风,必须显式写
{ video: true, audio: true },不能只写{} - 若只想开摄像头,
audio必须设为false(否则部分浏览器仍会弹麦克风权限请求) - 移动端 Safari 对
audio: true要求用户手势触发(如点击事件),否则静音或拒绝
async function startStream() {
try {
const stream = await navigator.mediaDevices.getUserMedia({
video: { width: 1280, height: 720 },
audio: true
});
document.getElementById('video').srcObject = stream;
} catch (err) {
console.error('获取媒体流失败:', err.name); // 如 "NotAllowedError", "NotFoundError"
}
}
怎么开关摄像头和麦克风(不中断流)
关键不是重新调用 getUserMedia(),而是操作流内轨道(MediaStreamTrack)的 enabled 属性。这能实时静音/黑屏,且不影响其他轨道或连接状态(比如 WebRTC 通话中可单独关麦)。
每个 MediaStream 的 getTracks() 返回轨道数组,需按 kind("video" 或 "audio")筛选:
立即学习“Java免费学习笔记(深入)”;
- 关摄像头:
stream.getVideoTracks()[0]?.enabled = false - 关麦克风:
stream.getAudioTracks()[0]?.enabled = false - 恢复只需设回
true,无需重启流 - 注意:某些老旧安卓 WebView 不支持
enabled,可用track.stop()代替(但会彻底停止轨道)
function toggleCamera(stream) {
const videoTrack = stream.getVideoTracks()[0];
if (videoTrack) videoTrack.enabled = !videoTrack.enabled;
}
function toggleMic(stream) {
const audioTrack = stream.getAudioTracks()[0];
if (audioTrack) audioTrack.enabled = !audioTrack.enabled;
}
MediaStreamTrack 的 stop() 和流的 getTracks().forEach(t => t.stop()) 有什么区别
stop() 是彻底终止单个轨道,释放硬件资源(摄像头灯灭、麦克风停采)。而 enabled = false 只是“静默”,设备仍在工作,只是数据不输出。
实际场景选择逻辑:
- 用户点击“结束视频”按钮 → 调用所有轨道的
stop(),再清空srcObject - 会议中临时闭麦 → 仅设
audioTrack.enabled = false,避免重连延迟 - 调用
stop()后,该轨道不可再启用,必须重新getUserMedia() - 流对象本身没有
stop()方法,必须遍历轨道调用
function stopAllTracks(stream) {
stream.getTracks().forEach(track => track.stop());
document.getElementById('video').srcObject = null;
}
为什么 getUserMedia() 在 iOS Safari 上经常失败或黑屏
iOS Safari 对媒体权限和生命周期限制极严,不是代码问题,而是平台策略:
- 首次调用必须由用户手势(
click、touchend)触发,定时器或异步回调中调用必失败 - 后台标签页中,即使已授权,
video轨道可能自动暂停(readyState === "ended"),切回前台也不会自动恢复 - 某些 iPad 型号默认禁用前置摄像头,需在系统设置中手动开启“相机”权限(不只是网站权限)
- 不支持
frameRate等高级约束,传入会导致OverconstrainedError
兼容建议:加兜底检测,比如监听 videoTrack.onended,并在切回前台时尝试 play() 触发恢复。










