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" />
- 安卓12及以下:
- 如果需要访问公共存储目录,在
<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
相关产品推荐
相关产品推荐

