Skip to main content
Version: 3.x

RecorderManager

全局唯一的录音管理器

参考文档

方法

onError

监听录音错误事件

支持情况:

参考文档

(callback: OnErrorCallback) => void
参数类型说明
callbackOnErrorCallback录音错误事件的回调函数

onFrameRecorded

监听已录制完指定帧大小的文件事件。如果设置了 frameSize,则会回调此事件。

支持情况:

参考文档

(callback: OnFrameRecordedCallback) => void
参数类型说明
callbackOnFrameRecordedCallback已录制完指定帧大小的文件事件的回调函数

onInterruptionBegin

监听录音因为受到系统占用而被中断开始事件。以下场景会触发此事件:微信语音聊天、微信视频聊天。此事件触发后,录音会被暂停。pause 事件在此事件后触发

支持情况:

参考文档

(callback: (res: TaroGeneral.CallbackResult) => void) => void
参数类型说明
callback(res: TaroGeneral.CallbackResult) => void录音因为受到系统占用而被中断开始事件的回调函数

onInterruptionEnd

监听录音中断结束事件。在收到 interruptionBegin 事件之后,小程序内所有录音会暂停,收到此事件之后才可再次录音成功。

支持情况:

参考文档

(callback: (res: TaroGeneral.CallbackResult) => void) => void
参数类型说明
callback(res: TaroGeneral.CallbackResult) => void录音中断结束事件的回调函数

onPause

监听录音暂停事件

支持情况:

参考文档

(callback: (res: TaroGeneral.CallbackResult) => void) => void
参数类型说明
callback(res: TaroGeneral.CallbackResult) => void录音暂停事件的回调函数

onResume

监听录音继续事件

支持情况:

参考文档

(callback: (res: TaroGeneral.CallbackResult) => void) => void
参数类型说明
callback(res: TaroGeneral.CallbackResult) => void录音继续事件的回调函数

onStart

监听录音开始事件

支持情况:

参考文档

(callback: (res: TaroGeneral.CallbackResult) => void) => void
参数类型说明
callback(res: TaroGeneral.CallbackResult) => void录音开始事件的回调函数

onStop

监听录音结束事件

支持情况:

参考文档

(callback: OnStopCallback) => void
参数类型说明
callbackOnStopCallback录音结束事件的回调函数

pause

暂停录音

支持情况:

参考文档

() => void

resume

继续录音

支持情况:

参考文档

() => void

start

开始录音

支持情况:

参考文档

(option: StartOption) => void
参数类型
optionStartOption

stop

停止录音

支持情况:

参考文档

() => void

参数

OnErrorCallback

录音错误事件的回调函数

(result: OnErrorCallbackResult) => void
参数类型
resultOnErrorCallbackResult

OnErrorCallbackResult

参数类型说明
errMsgstring错误信息

OnFrameRecordedCallback

已录制完指定帧大小的文件事件的回调函数

(result: OnFrameRecordedCallbackResult) => void
参数类型
resultOnFrameRecordedCallbackResult

OnFrameRecordedCallbackResult

参数类型说明
frameBufferArrayBuffer录音分片数据
isLastFrameboolean当前帧是否正常录音结束前的最后一帧

OnStopCallback

录音结束事件的回调函数

(result: OnStopCallbackResult) => void
参数类型
resultOnStopCallbackResult

OnStopCallbackResult

参数类型说明
durationnumber录音总时长,单位:ms
fileSizenumber录音文件大小,单位:Byte
tempFilePathstring录音文件的临时路径

StartOption

参数类型必填说明
audioSourcekeyof AudioSource指定录音的音频输入源,可通过 Taro.getAvailableAudioSources() 获取当前可用的音频源
durationnumber录音的时长,单位 ms,最大值 600000(10 分钟)
encodeBitRatenumber编码码率,有效值见下表格
formatkeyof Format音频格式
frameSizenumber指定帧大小,单位 KB。传入 frameSize 后,每录制指定帧大小的内容后,会回调录制的文件内容,不指定则不会回调。暂仅支持 mp3 格式。
numberOfChannelskeyof NumberOfChannels录音通道数
sampleRatekeyof SampleRate采样率

AudioSource

指定录音的音频输入源

参数说明
auto自动设置,默认使用手机麦克风,插上耳麦后自动切换使用耳机麦克风,所有平台适用
buildInMic手机麦克风,仅限 iOS
headsetMic耳机麦克风,仅限 iOS
mic麦克风(没插耳麦时是手机麦克风,插耳麦时是耳机麦克风),仅限 Android
camcorder同 mic,适用于录制音视频内容,仅限 Android
voice_communication同 mic,适用于实时沟通,仅限 Android
voice_recognition同 mic,适用于语音识别,仅限 Android

Format

音频格式

参数说明
mp3mp3 格式
aacaac 格式
wavwav 格式
PCMpcm 格式

NumberOfChannels

录音通道数

参数说明
11 个通道
22 个通道

SampleRate

采样率

参数说明编码码率
80008000 采样率16000 ~ 48000
1102511025 采样率16000 ~ 48000
1200012000 采样率24000 ~ 64000
1600016000 采样率24000 ~ 96000
2205022050 采样率32000 ~ 128000
2400024000 采样率32000 ~ 128000
3200032000 采样率48000 ~ 192000
4410044100 采样率64000 ~ 320000
4800048000 采样率64000 ~ 320000

API 支持度

API微信小程序H5React Native
RecorderManager.onError✔️✔️
RecorderManager.onFrameRecorded✔️
RecorderManager.onInterruptionBegin✔️
RecorderManager.onInterruptionEnd✔️
RecorderManager.onPause✔️✔️
RecorderManager.onResume✔️✔️
RecorderManager.onStart✔️✔️
RecorderManager.onStop✔️✔️
RecorderManager.pause✔️✔️
RecorderManager.resume✔️✔️
RecorderManager.start✔️✔️
RecorderManager.stop✔️✔️