安卓WebView调用摄像头权限如何配置？

Question

在安卓应用中，通过WebView调用摄像头时，常遇到权限配置问题。如何正确配置AndroidManifest.xml及动态权限请求，以实现WebView中H5页面顺利调用摄像头？

Answer 1

一、概述：WebView调用H5摄像头的权限配置问题

在Android应用中，通过WebView加载H5页面并调用摄像头功能时，开发者常遇到权限请求失败或无法访问摄像头的问题。这通常与AndroidManifest.xml中的权限声明不完整、动态权限请求未正确处理，以及WebView相关设置未启用摄像头支持有关。

1. AndroidManifest.xml中必须声明的权限

要在WebView中使用摄像头，首先需要在AndroidManifest.xml中添加以下权限：

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

其中，CAMERA权限是运行时权限，从Android 6.0（API 23）起必须动态申请；而uses-feature用于声明该应用依赖摄像头硬件。

2. 动态权限请求流程

由于CAMERA权限属于危险权限类别，在运行时需通过代码主动申请。以下是标准的权限请求流程：

1. 检查当前是否已授予CAMERA权限。
2. 如果未授权，则调用requestPermissions()方法发起请求。
3. 在onRequestPermissionsResult()回调中处理用户选择结果。

3. WebView相关配置

除了权限配置外，还需对WebView进行适当设置以允许H5页面访问摄像头。主要涉及以下几点：

• 启用JavaScript支持：mWebView.getSettings().setJavaScriptEnabled(true);
• 启用WebRTC：mWebView.getSettings().setMediaPlaybackRequiresUserGesture(false);
• 设置WebChromeClient以处理权限请求：

mWebView.setWebChromeClient(new WebChromeClient() {
    @Override
    public void onPermissionRequest(final PermissionRequest request) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
            request.grant(request.getResources());
        }
    }
});

4. 权限请求流程图（Mermaid格式）

graph TD
      A[启动WebView] --> B{是否已授权CAMERA?}
      B -- 是 --> C[直接加载H5页面]
      B -- 否 --> D[请求CAMERA权限]
      D --> E[用户授权/拒绝]
      E -- 授权 --> F[加载H5页面]
      E -- 拒绝 --> G[提示用户授权]

5. 常见问题及解决方案汇总表

问题现象	可能原因	解决办法
H5页面提示“无权限访问摄像头”	未在AndroidManifest.xml中声明CAMERA权限	补充权限声明
权限弹窗未出现	未调用requestPermissions()方法	添加动态权限请求逻辑
WebView加载H5后无法打开摄像头	未启用JavaScript或WebRTC支持	检查WebView设置
用户拒绝权限后无法再次请求	未处理shouldShowRequestPermissionRationale	根据返回值决定是否显示解释信息
WebView中视频流加载缓慢	未关闭用户手势限制	设置mediaPlaybackRequiresUserGesture为false

6. 完整示例代码片段

以下是一个完整的权限请求与WebView初始化代码示例：

public class MainActivity extends AppCompatActivity {
    private static final int REQUEST_CAMERA_PERMISSION = 1;
    private WebView mWebView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        mWebView = findViewById(R.id.webview);
        mWebView.getSettings().setJavaScriptEnabled(true);
        mWebView.getSettings().setMediaPlaybackRequiresUserGesture(false);
        mWebView.setWebChromeClient(new WebChromeClient() {
            @Override
            public void onPermissionRequest(final PermissionRequest request) {
                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
                    request.grant(request.getResources());
                }
            }
        });

        if (ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA)
                != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions(this,
                    new String[]{Manifest.permission.CAMERA},
                    REQUEST_CAMERA_PERMISSION);
        } else {
            loadCameraPage();
        }
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions,
                                           @NonNull int[] grantResults) {
        if (requestCode == REQUEST_CAMERA_PERMISSION) {
            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                loadCameraPage();
            } else {
                Toast.makeText(this, "权限被拒绝", Toast.LENGTH_SHORT).show();
            }
        }
    }

    private void loadCameraPage() {
        mWebView.loadUrl("https://your-h5-camera-page.com");
    }
}

7. 进阶建议

针对更复杂的应用场景，可以考虑如下进阶策略：

• 使用PermissionDispatcher等库简化权限请求逻辑。
• 对于多页面应用，可以在WebViewClient中监听URL变化，并动态控制权限。
• 结合后台服务监控权限状态，提供更友好的用户引导。