标题：WebView 中实现无需用户手势的持续视频流播放（Android）

本文详解如何在 android webview 中绕过 `mediaplaybackrequiresusergesture` 限制，通过 javascript 定期调用 `video.play()` 实现摄像头视频流的自动、连续播放，解决“视频仅闪现半秒即暂停”的典型问题。

在 android WebView 中加载本地 html 文件（如 file:///android_asset/camTheme.html）并调用 navigator.getUserMedia 启动摄像头时，即使已正确配置 setMediaPlaybackRequiresUserGesture(false)，视频仍常在初始帧后立即暂停——这是由于 Android WebView 对 file:// 协议下媒体自动播放的严格限制（尤其在 Android 9+ 及 Chromium 内核 WebView 中），该限制无法仅靠 java 层设置完全解除。

✅ 根本原因解析

• setMediaPlaybackRequiresUserGesture(false) 对 file:// 协议下的媒体播放无效（官方文档明确说明其主要影响 http(s):// 资源）；
• navigator.getUserMedia 返回的 Mediastream 赋予
• 用户触摸 WebView 触发的 play() 是唯一被允许的“合法手势”，故拖拽可恢复播放；
• autoplay=”true” muted 仅缓解音频限制，不解除 file:// 下的视频持续播放禁令。

✅ 推荐解决方案：javascript 层主动保活

最稳定、兼容性最佳的方式是在 HTML 中使用 setInterval 高频调用 video.play()，强制维持播放状态：

⚠️ 注意事项与优化建议

• 频率选择：15ms 是实测较优值（10ms 过于激进易触发异常，30ms 可能偶发卡顿）；
• 必须添加 playsinline 属性：防止 ios/ipadOS WebView 全屏播放中断流；
• 移除冗余权限： 是非法权限，会导致编译失败，应删除；
• Java 层精简配置（关键项保留，避免冲突）：

  WebSettings settings = webView.getSettings(); settings.setJavaScriptEnabled(true); settings.setDomStorageEnabled(true); settings.setAllowFileAccess(true); settings.setAllowContentAccess(true); settings.setAllowFileAccessFromFileURLs(true); settings.setAllowUniversalAccessFromFileURLs(true); // ⚠️ 仅调试用，发布前禁用 settings.setMediaPlaybackRequiresUserGesture(false); // 仍需保留，对 http(s) 有效 webView.setWebChromeClient(new WebChromeClient() {     @Override     public void onPermissionRequest(PermissionRequest request) {         // 仅对 file:// 授予 camera/mic 权限         if ("file:///".equals(request.getOrigin().toString())) {             request.grant(new String[]{PermissionRequest.RESOURCE_VIDEO_CAPTURE,                                       PermissionRequest.RESOURCE_AUDIO_CAPTURE});         } else {             request.deny();         }     } });

• 安全提醒：setAllowUniversalAccessFromFileURLs(true) 存在 xss 风险，仅用于调试；生产环境应改用 AssetFileDescriptor 或本地 HTTP Server（如 NanoHTTPD）提供 HTML。

✅ 替代方案（进阶）

若需彻底规避 file:// 限制，推荐将 HTML 移至 http://localhost:8080（通过内嵌轻量 HTTP 服务提供），此时 setMediaPlaybackRequiresUserGesture(false) 生效，且无需 setInterval 保活，代码更简洁、性能更优。

综上，setInterval + video.play() 是当前兼容性最强、实施成本最低的解决方案。它不依赖系统版本，无需 NDK 或复杂权限适配，可快速落地于各类 Android WebView 摄像头项目中。