核心是正确处理 getUserMedia 的拒绝、降级、兼容与状态同步：需满足安全上下文、用户手势触发，合理设置 constraints，区分错误类型引导用户，安全渲染流并及时停止轨道，注意移动端静音、设备变化监听及隐私风险。
浏览器里调用摄像头和麦克风，核心靠 navigator.mediaDevices.getUserMedia()，但直接调用常失败——不是权限被拒，就是设备不可用，或 Promise 永远 pending。关键不在“怎么写”，而在“怎么处理拒绝、降级、兼容和状态同步”。
getUserMedia 调用失败的常见原因与修复
最常见的错误是未满足安全上下文要求（比如 HTTP 环境下直接访问），或用户点击前就发起调用（Chrome 74+ 强制要求用户手势触发）。另外，constraints 写错也会静默失败：
-
{ video: true, audio: true }是最简写法，但某些安卓 WebView 或旧版 Safari 会因缺少分辨率/帧率约束而拒绝 - 避免写
{ video: { facingMode: "user" } }却不加 fallback：若前置摄像头不可用，整个 Promise 就 reject，应改用{ video: { facingMode: { ideal: "user" } } } - 部分 iOS 16.4+ Safari 对
audio: true在无用户交互页面上直接返回NotAllowedError，必须绑定到click或touchstart事件中
如何正确处理权限拒绝与设备缺失
不能只依赖 catch 打印错误，要区分类型并引导用户操作：
-
NotAllowedError：用户点了“拒绝”或系统级禁用，需提示打开设置（可跳转navigator.permissions.query({ name: 'camera' })检查状态） -
NotFoundError：设备不存在（如无摄像头的台式机），应降级 UI（隐藏预览区域，显示“无可用视频设备”） -
NotReadableError：设备被占用（如 Zoom 正在使用），建议提示“请关闭其他使用摄像头的应用” - 注意：Firefox 在用户选择“仅音频”后仍可能返回
video: false，但stream.getVideoTracks().length为 0，需手动判断轨道是否存在
拿到 MediaStream 后，如何安全渲染与控制
流对象本身不自动播放，也容易因页面切换、标签页失焦被浏览器暂停：
Handsfree Windows Control
下载
通过 handsfree-windows CLI控制 Windows 本机应用 (UIA) 和浏览器 (Playwright) 的引导技能，用于自动化或测试桌面应用。
立即学习“Java免费学习笔记（深入）”；
- 渲染视频：用
<video autoplay muted></video>标签，设srcObject = stream，**不要用src+ URL.createObjectURL()**（已废弃且内存泄漏） - 停止流：调用
stream.getTracks().forEach(track => track.stop())，仅停video或audio轨道时，分别遍历getVideoTracks()/getAudioTracks() - 监听设备变化：
navigator.mediaDevices.addEventListener('devicechange', handler)，但该事件不告诉你增删了哪个设备，需重新 enumerateDevices() 对比 - 移动端自动静音问题：Safari/iOS 要求
<video></video>加muted才能自动播放，否则需用户手动点一次
兼容性与生产环境注意事项
Edge 18 及更早版本用 navigator.getUserMedia（已废弃），现在基本可忽略；真正麻烦的是 Electron 和 Cordova 环境：
- Electron 22+ 默认禁用媒体设备，需在
webPreferences中显式开启webSecurity: false（不推荐）或配置permissions策略 - Cordova 需额外安装
cordova-plugin-media-capture或cordova-plugin-camera，纯 Web API 在 iOS Cordova 中多数失效 - WebRTC 带来的隐式后台采集风险：即使
<video></video>display: none，只要srcObject已赋值，摄像头仍在工作——务必在不需要时显式 stop 轨道 - 隐私指示器（如 macOS 绿灯、Windows 摄像头图标）只响应真实硬件采集，mock stream（如
new MediaStream()）不会触发
最易被忽略的一点：getUserMedia 返回的 stream 不是“一次性快照”，它持续采集，且不同设备的默认参数（如分辨率、帧率、是否自动对焦）差异极大；如果你需要稳定画质，必须显式声明 width/height/frameRate，并接受浏览器最终协商结果——而不是假设传了就一定生效。
