Cordova集成AppRTC调用InAppBrowser遇本地媒体访问失败问题

阿华AIGC实验室

2026-5-27

解决Cordova中InAppBrowser加载AppRTC时"failed to access local media"的问题

我看到你已经在AndroidManifest.xml里配置了必要的权限，但还是遇到了媒体访问失败的问题。结合你的Cordova 7.1.0 + cordova-android 6.3环境，这里有几个针对性的解决方案，你可以逐一排查：

1. 补充动态权限申请

你的清单文件里只声明了静态权限，但Android 6.0（API 23）及以上系统要求危险权限（如摄像头、麦克风）必须在运行时动态申请，静态声明只是提前告知系统应用需要这些权限。你需要通过Cordova权限插件来实现：

先安装权限插件：

cordova plugin add cordova-plugin-android-permissions

在应用的deviceready事件中添加权限申请逻辑：

document.addEventListener("deviceready", function() {
    const permissions = cordova.plugins.permissions;
    const requiredPermissions = [
        permissions.CAMERA,
        permissions.RECORD_AUDIO,
        permissions.MODIFY_AUDIO_SETTINGS
    ];

    // 检查并申请权限
    permissions.checkPermission(requiredPermissions[0], status => {
        if (!status.hasPermission) {
            permissions.requestPermissions(requiredPermissions, result => {
                result.hasPermission 
                    ? console.log("媒体权限申请成功") 
                    : console.log("权限被拒绝，无法使用视频通话");
            }, error => console.error("权限申请出错：", error));
        }
    }, error => console.error("检查权限出错：", error));
}, false);

2. 优化InAppBrowser的启动参数

默认的InAppBrowser配置可能没有开启WebRTC所需的媒体支持，你需要修改open方法的参数，添加媒体相关的允许设置：

InAppBrowser.open(
    "https://appr.tc/r/123", 
    "_blank", 
    "location=no,mediaPlaybackRequiresUserAction=no,allowInlineMediaPlayback=yes,enableViewportScale=yes"
);

关键参数说明：

mediaPlaybackRequiresUserAction=no：允许自动加载媒体流（无需用户手动触发）
allowInlineMediaPlayback=yes：支持内联渲染视频，适配WebRTC的视频播放逻辑

3. 检查CrossWalk WebView的配置

你的应用包名包含crosswalk，说明使用了CrossWalk插件替代系统WebView。需要确保CrossWalk支持WebRTC并配置正确：

确认cordova-plugin-crosswalk-webview的版本兼容cordova-android 6.3（建议使用2.4.0及以上版本）
在config.xml中添加CrossWalk的偏好设置，启用WebRTC支持：

<preference name="CrossWalkWebViewAnimatable" value="true" />
<!-- 可选：开启调试模式，方便查看WebView日志 -->
<preference name="CrossWalkWebViewDebug" value="true" />

4. 补充AndroidManifest.xml的硬件特性声明

除了权限，添加硬件特性声明可以帮助系统识别应用对摄像头、麦克风的依赖，避免兼容性问题：

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