Android Studio中WebView加载带二维码阅读器网站的摄像头权限问题求助

阿华AIGC实验室

2026-5-20

嘿，我碰到过好几个类似的WebView摄像头权限问题，虽然你说试过各种配置，但大概率是某个容易漏掉的细节没处理到位，给你列几个关键排查点，按顺序试：

核心排查与解决方案

1. 确认Manifest权限 + 动态权限申请完整度
先确保AndroidManifest.xml里的权限配置没遗漏：

<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera" android:required="true" />
<uses-feature android:name="android.hardware.camera.autofocus" android:required="false" />

然后在加载WebView的Activity/Fragment中，必须先完成动态权限申请（Android 6.0+强制要求）：

private static final int CAMERA_PERMISSION_CODE = 1001;

// 在初始化WebView前调用
private void checkCameraPermission() {
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA) != PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.CAMERA}, CAMERA_PERMISSION_CODE);
    } else {
        // 权限已授予，初始化WebView并加载网页
        initWebView();
    }
}

// 处理权限申请回调
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == CAMERA_PERMISSION_CODE) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            initWebView();
        } else {
            // 提示用户需要摄像头权限才能使用功能
            Toast.makeText(this, "需要授予摄像头权限才能使用二维码阅读器", Toast.LENGTH_SHORT).show();
        }
    }
}

重点：一定要等用户明确授予权限后，再初始化WebView加载网页，不要提前触发加载流程。

2. 配置WebSettings的核心参数
WebView的默认设置会限制很多媒体相关功能，必须开启以下几项：

private void initWebView() {
    WebSettings webSettings = webView.getSettings();
    webSettings.setJavaScriptEnabled(true); // 二维码阅读器依赖JS，必须开启
    webSettings.setAllowFileAccess(true);
    webSettings.setAllowContentAccess(true);
    webSettings.setMediaPlaybackRequiresUserGesture(false); // 允许自动触发摄像头请求（无需用户手动点击播放）
    
    // Android 9+ 允许混合内容（如果你的网站是HTTP协议，或包含HTTP资源）
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
        webSettings.setMixedContentMode(WebSettings.MIXED_CONTENT_ALWAYS_ALLOW);
    }
}

3. 重写WebChromeClient处理权限请求
这是最容易被忽略的关键步骤！WebView不会自动将摄像头权限请求转发给系统，必须通过WebChromeClient手动处理：

webView.setWebChromeClient(new WebChromeClient() {
    @Override
    public void onPermissionRequest(PermissionRequest request) {
        // 检查请求的资源是否包含摄像头权限
        for (String resource : request.getResources()) {
            if (resource.equals(PermissionRequest.RESOURCE_VIDEO_CAPTURE)) {
                request.grant(request.getResources()); // 直接授予摄像头权限
                return;
            }
        }
        super.onPermissionRequest(request);
    }

    // 可选：处理权限被取消的情况
    @Override
    public void onPermissionRequestCanceled(PermissionRequest request) {
        super.onPermissionRequestCanceled(request);
        Toast.makeText(MainActivity.this, "摄像头权限请求被取消", Toast.LENGTH_SHORT).show();
    }
});

如果你的二维码阅读器还需要麦克风权限，记得同时处理PermissionRequest.RESOURCE_AUDIO_CAPTURE。

4. 排查网站的Secure Context限制
浏览器和WebView都要求getUserMedia（摄像头调用API）在Secure Context（HTTPS或localhost）下运行：
- 如果你的网站是HTTP协议（非localhost），除了开启混合内容，还要确保WebView允许非HTTPS环境的媒体请求；
- 如果是本地file://协议加载网页，需要额外开启以下配置（Android 11+可能限制此API，建议改用HTTPS本地服务器）：
```
webSettings.setAllowFileAccessFromFileURLs(true);
webSettings.setAllowUniversalAccessFromFileURLs(true);
```
5. 高版本Android特殊限制排查
- Android 10+：检查系统权限管理中，App的摄像头权限是否被设置为"仅在使用时允许"，后台权限可能会导致调用失败；
- Android 13+：确保动态申请的权限数组包含CAMERA，新版本系统对权限分类更严格；
- 若仍有问题，可以尝试在Manifest中添加（非必需，但某些场景下能解决兼容性问题）：
```
<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES" />
```