本文详解如何在 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）并修正关键设置：
<!-- AndroidManifest.xml --> <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.CAMERA" /> <uses-permission android:name="android.permission.RECORD_AUDIO" /> <!-- 注意：SYSTEM_CAMERA 已废弃，无需声明 -->
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 事件 + 智能重试（更优雅、低开销）：
<!DOCTYPE html>
<html allow="camera,microphone">
<head>
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Camera Stream</title>
<style>
body, #container { margin: 0; padding: 0; height: 100vh; overflow: hidden; }
#container { display: flex; justify-content: center; align-items: center; }
#videoElement { width: 100vw; height: 100vh; object-fit: cover; }
</style>
</head>
<body>
<div id="container">
<video id="videoElement" autoplay muted playsinline></video>
</div>
<script>
const video = document.getElementById('videoElement');
// 兼容性处理 getUserMedia
const getUserMedia =
navigator.mediaDevices?.getUserMedia ||
navigator.getUserMedia ||
navigator.webkitGetUserMedia ||
navigator.mozGetUserMedia;
async function startStream() {
try {
const stream = await getUserMedia({ video: { facingMode: "environment" } });
video.srcObject = stream;
// 关键：监听 pause 事件，自动恢复播放
video.addEventListener('pause', () => {
// 防止重复调用
if (!video.paused) return;
video.play().catch(e => console.warn("Auto-resume failed:", e));
});
// 首次播放（显式调用，避免静音策略拦截）
await video.play();
} catch (err) {
console.error("Camera access denied or failed:", err);
document.body.innerHTML = `<h2 style="color:red">Camera Error: ${err.message}</h2>`;
}
}
// 延迟启动，确保 DOM 加载完成
document.addEventListener('DOMContentLoaded', startStream);
</script>
</body>
</html>✅ 补充建议与注意事项
- playsinline 属性必不可少：防止 iOS/iPadOS WebView 全屏播放中断流；
- muted + autoplay 组合：是绕过静音策略的基础（有声音需用户交互）；
- 避免 setTimeout(video.play, 500) 等延迟调用：时机不可控，易失效；
- 真机测试优先：模拟器通常无摄像头，且行为与真机差异大；
-
Android 10+ 隐私变更：若目标 SDK ≥ 29，需在 AndroidManifest.xml 中添加：
<application android:requestLegacyExternalStorage="true" ... >
（虽不影响摄像头，但常与文件访问相关联）。
综上，解决 WebView 视频流自动播放的核心在于：理解 file:// 的安全限制本质，以 allowUniversalAccess 解锁权限通道，再用事件驱动的 play() 重试机制替代暴力轮询。此方案兼顾稳定性、性能与可维护性，是生产环境推荐实践。
