更新记录

2.0.0（2026-08-04） 下载此版本

调整iOS采样率以支持讯飞语音转写

1.0.8（2026-01-27） 下载此版本

添加iOS实时分贝回调参数

1.0.7（2026-01-26） 下载此版本

支持实时分贝

平台兼容性

uni-app(4.75)

uni-app x(4.75)

wxz-record

支持PCM录音实时帧回调的UTS插件

功能特性

• ✅ 支持PCM格式录音
• ✅ 实时帧回调，可获取录音过程中的PCM数据
• ✅ 支持自定义采样率、声道数、位深
• ✅ 支持Android、iOS、HarmonyOS平台

使用方法

引入插件

import { startRecord, stopRecord, StartRecordOptions, StopRecordOptions } from '@/uni_modules/wxz-record'

开始录音

startRecord({
  config: {
    sampleRate: 16000, // 采样率，默认16000
    channels: 1, // 声道数，1=单声道，2=立体声，默认1
    bitsPerSample: 16, // 位深，8/16/24/32，默认16
    frameSize: 4096 // 帧大小（字节），每次回调的PCM数据大小，默认4096
  },
  onFrame: (data: ArrayBuffer) => {
    // 实时接收PCM数据帧
    console.log('收到PCM数据，大小:', data.byteLength)
    // 处理PCM数据...
  },
  success: (res) => {
    console.log('录音开始成功', res)
  },
  fail: (err) => {
    console.error('录音开始失败', err)
  }
})

停止录音

stopRecord({
  success: (res) => {
    console.log('录音停止成功', res)
    console.log('录音时长:', res.duration, 'ms')
  },
  fail: (err) => {
    console.error('录音停止失败', err)
  }
})

配置说明

录音配置参数

错误码

权限配置

Android

插件已自动配置 RECORD_AUDIO 权限，需要在应用manifest中声明。

iOS

插件已自动配置 NSMicrophoneUsageDescription，需要在Info.plist中配置权限说明。

HarmonyOS

插件已自动配置 ohos.permission.MICROPHONE 权限。

开发文档

UTS 语法 UTS API插件 UTS uni-app兼容模式组件 UTS 标准模式组件 Hello UTS