You need to enable JavaScript to run this app. Ionic Capacitor集成cordova-plugin-media录音报Error code1,无法存/放录音
优惠活动
大模型
产品
解决方案
定价
更多

Ionic Capacitor集成cordova-plugin-media录音报Error code1,无法存/放录音

核心问题定位

你遇到的Error: 1对应cordova-plugin-media定义的媒体操作中止错误,结合你已经测试过路径修改、格式替换仍未解决的场景,根本原因不是路径后缀问题,是Capacitor环境下的权限配置缺失、初始化时序错误,以及安卓高版本存储访问限制共同导致的。

第一步:补全权限配置(最高优先级)

Capacitor不会自动为Cordova插件补全高版本安卓要求的动态权限,这是出现Error 1的最常见原因:

  • 打开android/app/src/main/AndroidManifest.xml,手动添加以下权限:
    • 录音必需权限:<uses-permission android:name="android.permission.RECORD_AUDIO" />
    • 适配安卓版本的存储权限:
      • 安卓12及以下:<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
      • 安卓13及以上:<uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
    • 如果需要访问公共存储目录,在<application>标签内添加android:requestLegacyExternalStorage="true",适配安卓10+的分区存储限制。
  • 必须在平台ready后、初始化Media实例之前,主动弹窗动态申请对应权限,拿到用户授权后再创建Media对象,不要提前初始化。

第二步:修正文件路径逻辑

  • 放弃使用externalRootDirectory作为存储路径:安卓10+系统默认禁止应用直接写入公共根目录,就算加了兼容开关,多数定制ROM也会拦截写入操作。优先使用externalDataDirectory作为存储路径——这是应用专属的外部存储目录,不需要申请公共存储写入权限,不会被系统拦截。
  • 给Media插件传路径时,必须剔除file://前缀:cordova-plugin-media无法识别带file://前缀的路径,不要直接硬切前7个字符,要做兼容判断:
const rawStoragePath = this.file.externalDataDirectory;
const validMediaPath = rawStoragePath.startsWith('file://') ? rawStoragePath.replace('file://', '') : rawStoragePath;
this.audioFile = this.media.create(validMediaPath + 'audiofile.3gp');
  • 录音后缀不要硬用mp3:cordova-plugin-media在安卓端原生录音编码为3gp,硬写mp3后缀会导致文件编码和后缀不匹配,就算录音成功也无法正常播放。

第三步:修正录音/播放的时序问题

  • 你当前的代码在调用stopRecord()后马上触发play(),而stopRecord()是异步操作,需要把录音流写入磁盘生成完整文件,立刻调用播放时文件还未写完,自然无法播放也看不到文件。修改逻辑为等录音写入成功的回调触发后,延迟短时间再播放:
stop() {
  this.audioFile.stopRecord();
  // 等录音成功写入完成的回调触发后再启动播放
  this.audioFile.onSuccess.subscribe(() => {
    setTimeout(() => {
      this.audioFile.play();
    }, 300)
  })
}

额外兼容排查

  • 确认使用的cordova-plugin-media为6.x以上的最新版本,5.x及老版本对Capacitor的权限桥接存在已知兼容问题,插件安装完成后必须运行npx cap sync android完成原生配置同步。
  • 检查测试设备的系统权限设置:部分定制安卓系统(小米、OPPO、vivo等)会默认拦截应用的录音和存储权限,就算代码内申请了权限,也需要手动到系统设置中开启对应权限。

内容的提问来源于stack exchange,提问作者Mayank Kataria

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.07 05:45:10