Skip to main content
Version: 下个版本

RecorderManager

全局唯一的录音管理器

参考文档

方法#

onError#

监听录音错误事件

参考文档

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

API 支持度#

API微信小程序H5React Native
RecorderManager.onError✔️✔️

onFrameRecorded#

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

参考文档

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

API 支持度#

API微信小程序H5React Native
RecorderManager.onFrameRecorded✔️

onInterruptionBegin#

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

参考文档

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

API 支持度#

API微信小程序H5React Native
RecorderManager.onInterruptionBegin✔️

onInterruptionEnd#

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

参考文档

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

API 支持度#

API微信小程序H5React Native
RecorderManager.onInterruptionEnd✔️

onPause#

监听录音暂停事件

参考文档

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

API 支持度#

API微信小程序H5React Native
RecorderManager.onPause✔️✔️

onResume#

监听录音继续事件

参考文档

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

API 支持度#

API微信小程序H5React Native
RecorderManager.onResume✔️✔️

onStart#

监听录音开始事件

参考文档

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

API 支持度#

API微信小程序H5React Native
RecorderManager.onStart✔️✔️

onStop#

监听录音结束事件

参考文档

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

API 支持度#

API微信小程序H5React Native
RecorderManager.onStop✔️✔️

pause#

暂停录音

参考文档

() => void

API 支持度#

API微信小程序H5React Native
RecorderManager.pause✔️✔️

resume#

继续录音

参考文档

() => void

API 支持度#

API微信小程序H5React Native
RecorderManager.resume✔️✔️

start#

开始录音

参考文档

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

API 支持度#

API微信小程序H5React Native
RecorderManager.start✔️✔️

stop#

停止录音

参考文档

() => void

API 支持度#

API微信小程序H5React Native
RecorderManager.stop✔️✔️

参数#

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#

参数类型必填说明
audioSource"auto" | "buildInMic" | "headsetMic" | "mic" | "camcorder" | "voice_communication" | "voice_recognition"否指定录音的音频输入源，可通过 wx.getAvailableAudioSources() 获取当前可用的音频源
durationnumber否录音的时长，单位 ms，最大值 600000（10 分钟）
encodeBitRatenumber否编码码率，有效值见下表格
format"mp3" | "aac"否音频格式
frameSizenumber否指定帧大小，单位 KB。传入 frameSize 后，每录制指定帧大小的内容后，会回调录制的文件内容，不指定则不会回调。暂仅支持 mp3 格式。
numberOfChannels1 | 2否录音通道数
sampleRate8000 | 11025 | 12000 | 16000 | 22050 | 24000 | 32000 | 44100 | 48000否采样率

audioSource#

指定录音的音频输入源

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

format#

音频格式

参数说明
mp3mp3 格式
aacaac 格式

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✔️✔️
Edit this page