更新记录

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 不提供峰值,返回录制状态占位值
暂停续录 支持 支持

注意事项

  1. 需要自定义基座。插件在 AndroidManifest.xml 里声明了 RECORD_AUDIO、FOREGROUND_SERVICE、FOREGROUND_SERVICE_MICROPHONE 以及 RecorderService,这些必须重新打包才生效。标准基座会因为「未在清单中注册 RECORD_AUDIO」直接抛异常。
  2. 麦克风权限是运行时申请,插件内部已处理(拒绝返回 9110002)。若用户勾选「不再询问」,需引导到系统设置。
  3. Android 7.0 以下不支持暂停(MediaRecorder.pause 从 API 24 开始),会返回 9110005。WAV 格式不受此限制。
  4. WAV 是无损但体积大:44.1kHz 单声道约 88KB/秒,1 小时约 300MB。长录音建议用 AAC。
  5. 通话录音不在支持范围。系统限制第三方应用录制通话双方声音,这是平台行为。

错误码

错误码 说明
9110001 参数错误
9110002 麦克风权限被拒绝,请在系统设置中开启
9110003 当前没有进行中的录音
9110004 录音失败
9110005 当前格式不支持(如低版本系统暂停)
9110006 文件写入失败

兼容性

  • Android 5.0+(API 21),暂停功能需 Android 7.0+
  • HarmonyOS NEXT
  • uni-app x(HBuilderX 4.25+)
  • 需要自定义基座

隐私、权限声明

1. 本插件需要申请的系统权限列表:

需要麦克风权限(运行时申请);后台录制使用前台服务,Android 8+ 必须有常驻通知,可通过配置降低通知干扰但不能完全移除

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

录音文件仅保存在本机,插件不采集、不上传任何音频数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

暂无用户评论。