本文详解如何在 android webview 中绕过 `mediaplaybackrequiresusergesture` 限制，通过 javascript 主动轮询 + java 权限/配置协同优化，实现 `file://` 本地 html 页面中摄像头视频流的自动、连续、静音播放。
在 Android WebView 中加载本地 HTML 页面并调用摄像头（如 navigator.getUserMedia）时，即使已正确配置 setMediaPlaybackRequiresUserGesture(false)，视频流仍常在启动后瞬间暂停——这是由于 Android WebView 对媒体自动播放（尤其是 file:// 协议）存在双重限制：
- 策略层限制：从 Android 5.0（API 21）起，WebView 默认强制要求媒体播放需由用户手势（如点击、触摸）触发；
- 协议层限制：file:// 协议被视作非安全上下文（insecure context），现代 Chromium 内核（WebView 底层）会主动禁用 getUserMedia 的自动授权与持续播放能力，即使权限已授予。
尽管你已在 Java 层设置了 setMediaPlaybackRequiresUserGesture(false) 并在 HTML 中添加了 allow="camera,microphone"，但仅靠该设置无法突破 file:// 下的自动播放策略。真正的解决方案需“软硬结合”：Java 层确保权限与基础配置就绪，JavaScript 层主动维持播放状态。
✅ 正确的 Java 配置要点（精简+修正）
首先，清理冗余权限声明（如重复的 INTERNET、无效的 android.webkit.PermissionRequest）并修正关键设置：
WebView 初始化时，重点配置如下（移除重复项，增强兼容性）：
WebSettings settings = webView.getSettings();
settings.setJavaScriptEnabled(true);
settings.setDomStorageEnabled(true);
settings.setDatabaseEnabled(true);
settings.setAllowFileAccess(true);
settings.setAllowContentAccess(true);
settings.setAllowFileAccessFromFileURLs(true);
settings.setAllowUniversalAccessFromFileURLs(true); // ⚠️ 关键：允许 file:// 访问跨域资源
settings.setMediaPlaybackRequiresUserGesture(false); // ⚠️ 必须设置，但单独不够
// 启用 WebChromeClient 处理权限请求（适配旧版 API）
webView.setWebChromeClient(new WebChromeClient() {
@Override
public void onPermissionRequest(PermissionRequest request) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
// 仅对 file:/// 源授予权限（你的逻辑正确）
if ("file:///".equals(request.getOrigin().toString())) {
request.grant(request.getResources());
} else {
request.deny();
}
}
}
});
webView.loadUrl("file:///android_asset/camTheme.html");? 注意：setAllowUniversalAccessFromFileURLs(true) 是 file:// 下启用摄像头的关键开关（尤其在 Android 7.0+），但该设置存在安全风险，仅限可信本地 HTML 使用。
✅ 健壮的 HTML/JS 实现（避免 setInterval 过度轮询）
原答案中使用 setInterval(() => video.play(), 10) 虽能“凑效”，但存在严重问题：
- 频繁调用 play() 可能触发浏览器错误（如 DOMException: The play() request was interrupted）；
- 10ms 间隔无实际意义（视频帧率通常 30fps ≈ 33ms/帧），反而增加 CPU 开销；
- 未处理 play() Promise 拒绝，导致静默失败。
推荐方案：监听 pause 事件 + 智能重试（更优雅、低开销）：
Camera Stream
✅ 补充建议与注意事项
- playsinline 属性必不可少：防止 iOS/iPadOS WebView 全屏播放中断流；
- muted + autoplay 组合：是绕过静音策略的基础（有声音需用户交互）；
- 避免 setTimeout(video.play, 500) 等延迟调用：时机不可控，易失效；
- 真机测试优先：模拟器通常无摄像头，且行为与真机差异大；
-
Android 10+ 隐私变更：若目标 SDK ≥ 29，需在 AndroidManifest.xml 中添加：
（虽不影响摄像头，但常与文件访问相关联）。
综上，解决 WebView 视频流自动播放的核心在于：理解 file:// 的安全限制本质，以 allowUniversalAccess 解锁权限通道，再用事件驱动的 play() 重试机制替代暴力轮询。此方案兼顾稳定性、性能与可维护性，是生产环境推荐实践。
