更新记录

1.0.0（2026-01-21）

新版本发布，支持后台、息屏录音

平台兼容性

uni-app(3.8.0)

其他

muzi-audio-recorder 原生录音插件

1. 插件简介

muzi-audio-recorder 是一款基于 Vue3 Options API 开发的高性能原生录音组件。它专为 UniApp 生态设计，支持暂停、续录、后台录音及息屏录制，具有极简的集成方式和高度美观的 UI 设计。

• 适用场景：语音笔记、社交聊天、音频采集、长时间会议记录等。

2. 功能特性

• ✅ 全状态控制：支持开始、停止及删除录音。
• ✅ 无时长限制：支持长时间录制，性能稳定。
• ✅ 后台/息屏录音：在 App 切后台或手机息屏状态下依然保持录制。
• ✅ 暗黑模式：原生适配系统暗黑主题，视效丝滑。
• ✅ 零依赖：不使用任何第三方 UI 库，代码精简，体积小巧。
• ✅ 管理方便：内置录音列表及播放器，支持录音试听与清空。

3. 兼容性

4. 快速上手

4.1 安装方式

本插件符合 uni_modules 规范，直接下载并导入项目的 uni_modules 目录即可。

4.2 权限配置 (重要)

为了确保后台录音和息屏录音功能正常，请在 manifest.json 中进行如下配置：

Android 权限声明：

/* app-plus -> distribute -> android -> permissions */
[
  "<uses-permission android:name=\"android.permission.RECORD_AUDIO\"/>",
  "<uses-permission android:name=\"android.permission.WAKE_LOCK\"/>",
  "<uses-permission android:name=\"android.permission.WRITE_EXTERNAL_STORAGE\"/>"
]

iOS 后台模式：

/* app-plus -> distribute -> ios -> UIBackgroundModes */
["audio"]

5. 使用示例

由于支持 easycom，你无需引入组件即可直接在页面中使用。

<template>
  <view>
    <muzi-audio-recorder ref="recorder"></muzi-audio-recorder>

    <button @click="getAudioData">获取已录制文件</button>
  </view>
</template>

<script>
export default {
  methods: {
    getAudioData() {
      // 通过 ref 拿到组件内部的音频列表
      const list = this.$refs.recorder.audioList;
      console.log('当前录音列表：', list);
    }
  }
}
</script>

6. API 文档

6.1 组件 Ref 属性

通过 ref 访问组件实例，可以获取以下核心数据：

6.2 录音对象结构

audioList 中的每个对象包含以下字段：

• path: 录音文件的临时存放路径。
• duration: 录音时长（单位：秒）。
• createTime: 录音完成的时间戳字符串。

7. 注意事项

1. 真机调试：录音属于原生功能，请务必在真机环境下运行，H5 模式仅供 UI 预览。
2. 存储空间：录音文件默认存储在应用临时目录，建议在业务逻辑中及时上传至服务器或移动到永久目录。
3. 音频焦点：录音时如果系统接收到电话或启动其他音频应用，录音可能会由于硬件冲突被强制停止。

8. 授权说明

本插件为付费插件，仅限在授权的项目中使用。未经许可，禁止二次售卖或直接分发源码。