Cordova安卓应用通过URI访问媒体文件的最简方案及问题求助

构建崩溃问题修复 #

你遇到的构建报错是因为AndroidInsecureFileModeEnabled配置仅支持 Cordova Android 10.0 及以上版本，低于该版本的平台无法识别此属性，两种修复方案可选：

• 方案1：升级Cordova Android平台到最新版本
  执行命令：

  cordova platform rm android
  cordova platform add android@latest
  

• 方案2：保留当前平台版本，删除AndroidInsecureFileModeEnabled配置，替换为旧版本兼容配置
  在config.xml的android平台节点下添加：

  <preference name="AllowFileAccess" value="true" />
  <preference name="AllowUniversalAccessFromFileURLs" value="true" />
  

补充：Cordova Android 10+ 已经内置白名单能力，不需要额外安装cordova-plugin-whitelist插件，已安装的话可以卸载避免冲突，执行命令：cordova plugin rm cordova-plugin-whitelist

媒体文件访问权限拒绝问题修复 #

本地file://协议媒体文件

1. 动态申请存储权限
   安卓6.0及以上系统需要动态申请存储权限才能访问本地公共目录文件，安装cordova-plugin-android-permissions插件，在应用启动后、访问文件前先执行权限申请：

   const permissions = cordova.plugins.permissions;
   permissions.checkPermission(permissions.READ_EXTERNAL_STORAGE, res => {
     if (!res.hasPermission) {
       permissions.requestPermission(permissions.READ_EXTERNAL_STORAGE, () => {
         // 权限申请通过，执行后续文件访问逻辑
       }, () => {
         alert("请授予存储权限后重试");
       });
     }
   });
   

2. 转换路径为WebView可访问格式
   不要直接传入原生绝对路径的file://地址给Howler.js，需要通过cordova-plugin-file的API转换为WebView有权限访问的路径：

   window.resolveLocalFileSystemURI("你的原始file://路径", entry => {
     const accessibleUrl = entry.toURL();
     // 传入转换后的路径给Howler
     const sound = new Howl({
       src: [accessibleUrl]
     });
     sound.play();
   }, err => {
     console.log("路径解析失败：", err);
   });
   

远程https协议媒体文件

1. 检查远程服务器CORS配置，需要允许跨域访问，添加响应头Access-Control-Allow-Origin: *即可，WebView默认的file://源很多服务端默认会拦截跨域请求。
2. 如果你的远程资源是http协议，安卓9.0及以上默认禁用明文流量，需要在config.xml的android平台节点下添加配置：

   <preference name="CleartextTrafficPermitted" value="true" />
   

内容的提问来源于stack exchange，提问作者Amorphia