更新记录

1.0.0（2026-04-18）

-支持 Android / iOS 原生录音 -支持录音权限申请 -支持开始、暂停、恢复、停止 -支持自定义分片时长 -支持保留原始分片并输出合并文件 -支持返回录音文件路径，便于业务侧播放、上传和转写

平台兼容性

uni-app(4.75)

uni-app x(4.75)

austin-recorder

简介

austin-recorder 是一个UTS后台录音引擎插件，支持录音权限申请、开始 / 暂停 / 恢复 / 停止、分片落盘、状态回调、会话管理和录音文件输出。

当前插件下的是通用模板页演示：

• 录音权限申请
• 开始 / 暂停 / 恢复 / 停止录音
• 自定义分片时长
• 分片文件输出
• 会话列表查询
• 合并文件路径输出

功能特性

• 支持 Android / iOS 原生录音
• 支持自定义时间自动切片
• 支持暂停和恢复
• 支持录音状态回调
• 支持实时分贝回调
• 支持分片文件回调
• 支持分片合并输出文件回调
• 支持查询当前会话和历史会话
• 支持删除会话及其文件
• 默认输出 m4a(AAC) 文件，在 Android / iOS 原生录音场景中更稳定，且文件体积通常更小
• 原始分片保留不删，停止后额外生成 merged.m4a

manifest.json 权限配置

根项目 manifest.json 需要补齐以下权限。

Android

在 app-plus.distribute.android.permissions 中添加：

{
  "app-plus": {
    "distribute": {
      "android": {
        "permissions": [
          "<uses-permission android:name=\"android.permission.RECORD_AUDIO\"/>",
          "<uses-permission android:name=\"android.permission.FOREGROUND_SERVICE\"/>",
          "<uses-permission android:name=\"android.permission.FOREGROUND_SERVICE_MICROPHONE\"/>",
          "<uses-permission android:name=\"android.permission.WAKE_LOCK\"/>"
        ]
      }
    }
  }
}

字段说明：

• RECORD_AUDIO：录音必需权限
• FOREGROUND_SERVICE：前台服务权限
• FOREGROUND_SERVICE_MICROPHONE：前台录音服务权限
• WAKE_LOCK：保持录音过程中的运行稳定性

iOS

在 app-plus.distribute.ios.privacyDescription 中添加：

{
  "app-plus": {
    "distribute": {
      "ios": {
        "privacyDescription": {
          "NSMicrophoneUsageDescription": "用于后台录音、业务留痕和语音采集"
        }
      }
    }
  }
}

说明：

• NSMicrophoneUsageDescription 是 iOS 麦克风权限弹窗文案，未配置时应用无法正常通过权限申请
• 文案建议按你的真实业务场景改写，不要直接写成和插件无关的用途

字段描述

StartRecorderOptions

RecorderPermissionResult

RecorderStateEvent

RecorderMeteringEvent

RecorderSegmentInfo

RecorderSessionInfo

RecorderStatus

RecorderFail

使用示例

1. 申请录音权限

import { requestRecorderPermission } from '@/uni_modules/austin-recorder'

requestRecorderPermission({
  success(res) {
    console.log('permission-success', res)
  },
  fail(err) {
    console.log('permission-fail', err)
  },
})

2. 开始后台录音

import { startRecorder } from '@/uni_modules/austin-recorder'

startRecorder({
  scene: 'background-record',
  segmentDurationMs: 10000,
  maxDurationMs: 60 * 60 * 1000,
  enableMetering: true,
  onStateChange(event) {
    console.log('state', event)
  },
  onMetering(event) {
    console.log('meter', event)
  },
  onSegmentReady(segment) {
    console.log('segment-file', segment.filePath)
    console.log('segment', segment)
  },
  success(session) {
    console.log('session-start', session)
  },
  fail(err) {
    console.log('start-fail', err)
  },
})

3. 停止录音并获取合并文件

import { stopRecorder } from '@/uni_modules/austin-recorder'

stopRecorder({
  reason: 'manual-stop',
  success(session) {
    console.log('merged-file', session.mergedFilePath)
    console.log('session-stop', session)
  },
  fail(err) {
    console.log('stop-fail', err)
  },
})

4. 查询当前状态和会话

import {
  getRecorderStatusSync,
  getCurrentSessionSync,
  listRecorderSessionsSync,
  listRecorderSegmentsSync,
} from '@/uni_modules/austin-recorder'

const status = getRecorderStatusSync()
const currentSession = getCurrentSessionSync()
const sessions = listRecorderSessionsSync()
const segments = currentSession ? listRecorderSegmentsSync(currentSession.sessionId) : []

console.log('status', status)
console.log('currentSession', currentSession)
console.log('sessions', sessions)
console.log('segments', segments)