如何为Gecko View配置WebRTC权限？Android项目摄像头权限无效排查

阿华AIGC实验室

2026-5-12

解决GeckoView中WebRTC摄像头权限无响应的问题

嘿，我来帮你搞定这个GeckoView的WebRTC权限问题！你已经在Manifest里配置了基础权限，但光这样还不够——GeckoView处理WebRTC相关的摄像头/麦克风权限，需要结合动态运行时权限申请和GeckoSession权限委托来完成，下面一步步拆解：

1. 补充Manifest缺失的权限

你当前的Manifest里缺少了WebRTC必需的麦克风权限（即使只用到摄像头，部分WebRTC场景也依赖这个权限），先补上：

<uses-permission android:name="android.permission.RECORD_AUDIO" />

另外如果你的App需要支持无摄像头设备，可以把摄像头相关的feature设置为可选：

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

2. 动态请求运行时权限

Android 6.0（API 23）及以上，危险权限（比如CAMERA、RECORD_AUDIO）必须在代码中动态申请，不能仅靠Manifest配置。你可以在Activity/Fragment中添加权限检查逻辑：

private static final int REQUEST_WEBRTC_PERMISSIONS = 1001;
private String[] WEBRTC_PERMISSIONS = {
    Manifest.permission.CAMERA,
    Manifest.permission.RECORD_AUDIO
};

// 检查并请求WebRTC相关权限
private void checkWebRTCPermissions() {
    List<String> missingPermissions = new ArrayList<>();
    for (String perm : WEBRTC_PERMISSIONS) {
        if (ContextCompat.checkSelfPermission(this, perm) != PackageManager.PERMISSION_GRANTED) {
            missingPermissions.add(perm);
        }
    }
    if (!missingPermissions.isEmpty()) {
        ActivityCompat.requestPermissions(this, missingPermissions.toArray(new String[0]), REQUEST_WEBRTC_PERMISSIONS);
    }
}

3. 配置GeckoSession的权限委托

这是最关键的一步：GeckoView不会自动处理网页的权限请求，你需要通过GeckoSession.PermissionDelegate接管摄像头、麦克风等权限的申请逻辑，让网页能正常获取权限。

初始化GeckoSession时要先启用WebRTC相关设置，再绑定权限委托：

private GeckoSession mGeckoSession;
private GeckoSession.PermissionDelegate.Callback mCameraCallback;
private GeckoSession.PermissionDelegate.Callback mMicCallback;

private void initGeckoView() {
    mGeckoSession = new GeckoSession();
    GeckoSettings settings = mGeckoSession.getSettings();
    // 启用WebRTC和媒体捕获功能
    settings.setWebRTCEnabled(true);
    settings.setMediaCaptureEnabled(true);

    // 设置权限委托，处理网页的权限请求
    mGeckoSession.setPermissionDelegate(new GeckoSession.PermissionDelegate() {
        @Override
        public void onCameraPermissionRequest(String uri, int videoType, Callback callback) {
            mCameraCallback = callback;
            // 检查摄像头权限，未授权则发起请求
            if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.CAMERA) != PackageManager.PERMISSION_GRANTED) {
                ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.CAMERA}, REQUEST_CAMERA_PERMISSION);
            } else {
                // 已授权，直接允许网页使用摄像头
                callback.grant(videoType);
            }
        }

        @Override
        public void onMicrophonePermissionRequest(String uri, Callback callback) {
            mMicCallback = callback;
            if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.RECORD_AUDIO) != PackageManager.PERMISSION_GRANTED) {
                ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.RECORD_AUDIO}, REQUEST_MIC_PERMISSION);
            } else {
                callback.grant();
            }
        }

        // 按需处理其他权限请求（比如位置权限）
        @Override
        public void onLocationPermissionRequest(String uri, Callback callback) {
            // 此处添加位置权限处理逻辑
        }
    });

    // 将GeckoSession绑定到GeckoView
    GeckoView geckoView = findViewById(R.id.gecko_view);
    geckoView.setSession(mGeckoSession);
    mGeckoSession.open(new GeckoRuntime(this));
}

4. 处理权限请求结果

在Activity/Fragment中重写权限回调方法，把用户的权限选择结果通知给GeckoSession：

private static final int REQUEST_CAMERA_PERMISSION = 1002;
private static final int REQUEST_MIC_PERMISSION = 1003;

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    switch (requestCode) {
        case REQUEST_CAMERA_PERMISSION:
            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                if (mCameraCallback != null) {
                    mCameraCallback.grant(GeckoSession.PermissionDelegate.Callback.VIDEO);
                }
            } else {
                if (mCameraCallback != null) {
                    mCameraCallback.reject();
                }
            }
            mCameraCallback = null;
            break;
        case REQUEST_MIC_PERMISSION:
            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                if (mMicCallback != null) {
                    mMicCallback.grant();
                }
            } else {
                if (mMicCallback != null) {
                    mMicCallback.reject();
                }
            }
            mMicCallback = null;
            break;
        case REQUEST_WEBRTC_PERMISSIONS:
            // 批量权限请求后的后续处理
            break;
    }
}