更新记录
1.0.0(2026-11-19)
首次发布:完成 Android / HarmonyOS 双端实现与真机验证。
平台兼容性
uni-app x(4.25)
| Chrome |
Safari |
Android |
iOS |
鸿蒙 |
微信小程序 |
| × |
× |
√ |
× |
√ |
× |
其他
| 多语言 |
暗黑模式 |
宽屏模式 |
蒸汽模式 |
| × |
× |
× |
√ |
uni-audio-recorder · 录音
专业录音插件:AAC / WAV / AMR 三种格式,支持暂停续录、后台与锁屏录制、通知栏暂停/停止控制、实时音量回调(可画波形)。纯系统 API,无三方 SDK。
能力
| 能力 |
说明 |
| 三种格式 |
aac(m4a,默认,兼容主流语音识别)/ wav(PCM 无损)/ amr(老设备兼容) |
| 参数可配 |
采样率 8k/16k/44.1k/48k、单/双声道、码率 |
| 暂停续录 |
同一文件断点续录,不切片、不重启录音器 |
| 后台录制 |
前台服务保活,熄屏、切后台、锁屏均不中断 |
| 通知栏控制 |
暂停 / 继续 / 停止,不用打开 App 就能操作 |
| 三档通知 |
full / minimal / hidden,运行中可随时切换 |
| 实时音量 |
getAmplitude() 返回 0~100(已做对数压缩),可直接画柱状波形 |
| 状态查询 |
时长、文件大小、是否暂停、实际格式 |
快速上手
import { startRecord, pauseRecord, resumeRecord, stopRecord, getAmplitude } from '@/uni_modules/uni-audio-recorder'
// 开始(默认 AAC / 44.1kHz / 单声道 / 完整通知)
startRecord({
format: 'aac',
sampleRate: 44100,
notification: 'full',
success: (res) => console.log('录制中', res.path),
fail: (err) => console.log(err.errMsg),
})
// 画波形:150ms 轮询一次
setInterval(() => {
getAmplitude({ success: (res) => bars.push(res.amplitude) })
}, 150)
pauseRecord() // 暂停
resumeRecord() // 接着录同一个文件
stopRecord({ success: (res) => console.log(res.duration, res.size) })
API
| 方法 |
参数 |
说明 |
startRecord(options) |
{path?, format?, sampleRate?, channels?, bitRate?, notification?} |
申请麦克风权限后开始录制 |
pauseRecord(options?) |
— |
暂停(Android 7.0+;WAV 走内部暂停) |
resumeRecord(options?) |
— |
继续,写入同一文件 |
stopRecord(options?) |
— |
停止并落盘,返回时长与大小 |
getState(options) |
— |
查询状态 |
getAmplitude(options) |
— |
实时音量 0~100 |
setNotification(options) |
{notification} |
运行中切换通知栏样式 |
通知栏三档的真实行为
Android 8+ 的前台服务必须有通知,否则系统几秒内就会清理进程、录音中断。所以三档是这样:
| 档位 |
实际效果 |
full |
完整通知:标题、实时时长、暂停/停止按钮,点击回到 App |
minimal |
最低优先级:无声、无震动、不弹横幅、不进锁屏,通知抽屉里保留一行 |
hidden |
不显示标题与内容;Android 13+ 用户可把通知划掉(服务继续运行),抽屉「活动应用」区仍会列出 |
想要「零通知」就必须放弃前台服务,而 Android 会把普通后台服务限制掉,录音几分钟后就断。插件按「优先保证不中断」设计,hidden 已做到系统允许的上限。
平台差异
| 能力 |
Android |
鸿蒙 |
| 录音格式 |
AAC / WAV / AMR |
AAC / WAV / AMR(AVRecorder) |
| 后台录制 |
前台服务(microphone 类型) |
backgroundTaskManager 长时任务 |
| 通知栏控制 |
暂停/继续/停止按钮 |
常驻通知(受系统样式限制,无自定义按钮) |
| 实时音量 |
MediaRecorder 峰值 / AudioRecord RMS |
不提供峰值,返回录制状态占位值 |
| 暂停续录 |
支持 |
支持 |
注意事项
- 需要自定义基座。插件在
AndroidManifest.xml 里声明了 RECORD_AUDIO、FOREGROUND_SERVICE、FOREGROUND_SERVICE_MICROPHONE 以及 RecorderService,这些必须重新打包才生效。标准基座会因为「未在清单中注册 RECORD_AUDIO」直接抛异常。
- 麦克风权限是运行时申请,插件内部已处理(拒绝返回
9110002)。若用户勾选「不再询问」,需引导到系统设置。
- Android 7.0 以下不支持暂停(
MediaRecorder.pause 从 API 24 开始),会返回 9110005。WAV 格式不受此限制。
- WAV 是无损但体积大:44.1kHz 单声道约 88KB/秒,1 小时约 300MB。长录音建议用 AAC。
- 通话录音不在支持范围。系统限制第三方应用录制通话双方声音,这是平台行为。
错误码
| 错误码 |
说明 |
| 9110001 |
参数错误 |
| 9110002 |
麦克风权限被拒绝,请在系统设置中开启 |
| 9110003 |
当前没有进行中的录音 |
| 9110004 |
录音失败 |
| 9110005 |
当前格式不支持(如低版本系统暂停) |
| 9110006 |
文件写入失败 |
兼容性
- Android 5.0+(API 21),暂停功能需 Android 7.0+
- HarmonyOS NEXT
- uni-app x(HBuilderX 4.25+)
- 需要自定义基座