uni-app
uni-app x
uniCloud
HBuilder
uni 小程序 sdk
uni-app x
uni-app
uni-app x
uniCloud
HBuilder
uni 小程序 sdk
简体中文
API
uni.getRecorderManager()
getRecorderManager 兼容性
返回值
RecorderManager 的方法
start(options : RecorderManagerStartOptions) : void;
pause() : void;
resume() : void;
stop() : void;
onStart(options : (result : any) => void) : void;
onPause(options : (result : any) => void) : void;
展示全部

# uni.getRecorderManager()

录音管理

# getRecorderManager 兼容性

Web 微信小程序 Android Android uni-app x UTS 插件 iOS iOS uni-app x UTS 插件 HarmonyOS
x 4.41 4.61 4.61 4.61 4.61 4.61

# 返回值

类型
RecorderManager

# RecorderManager 的方法

# start(options : RecorderManagerStartOptions) : void;

开始录音

# start 兼容性
Web 微信小程序 Android iOS HarmonyOS
x 4.41 4.61 4.61 4.61
# 参数
名称 类型 必填 默认值 兼容性 描述
options RecorderManagerStartOptions 是 - - -
名称 类型 必备 默认值 兼容性 描述
duration number 否 -
指定录音的时长，单位 ms ，如果传入了合法的 duration ，在到达指定的 duration 后会自动停止录音，最大值 600000（10 分钟）,默认值 60000（1 分钟）
sampleRate number 否 -
采样率，有效值 8000/16000/44100
numberOfChannels number 否 -
录音通道数，有效值 1/2
encodeBitRate number 否 -
编码码率，有效值见下表格
format string 否 -
音频格式，App-Android 默认值为 aac，小程序默认值 aac，HarmonyOS 默认 acc，HarmonyOS只支持 aac
合法值 兼容性 描述
aac - aac格式
mp3 - mp3格式
pcm - pcm格式
wav - wav格式
frameSize number 否 -
指定帧大小，单位 KB。传入 frameSize 后，每录制指定帧大小的内容后，会回调录制的文件内容，不指定则不会回调。暂仅支持 mp3 格式。

# pause() : void;

暂停录音,App-Android平台在Android 7.0及以后版本支持

# pause 兼容性
Web 微信小程序 Android 系统版本 Android iOS HarmonyOS
x 4.41 7.0 4.61 4.61 4.61

# resume() : void;

继续录音，App-Android平台在Android 7.0及以后版本支持

# resume 兼容性
Web 微信小程序 Android 系统版本 Android iOS HarmonyOS
x 4.41 7.0 4.61 4.61 4.61

# stop() : void;

停止录音

# stop 兼容性
Web 微信小程序 Android iOS HarmonyOS
x 4.41 4.61 4.61 4.61

# onStart(options : (result : any) => void) : void;

录音开始事件

# onStart 兼容性
Web 微信小程序 Android iOS HarmonyOS
x 4.41 4.61 4.61 4.61
# 参数
名称 类型 必填 默认值 兼容性 描述
options (result: any) => void 是 - - -

# onPause(options : (result : any) => void) : void;

录音暂停事件,App-Android平台在Android 7.0及以后版本支持

# onPause 兼容性
Web 微信小程序 Android 系统版本 Android iOS HarmonyOS
x 4.41 7.0 4.61 4.61 4.61
# 参数
名称 类型 必填 默认值 兼容性 描述
options (result: any) => void 是 - - -

# onStop(options : (result : RecorderManagerOnStopResult) => void) : void;

录音停止事件，会回调文件地址

# onStop 兼容性
Web 微信小程序 Android iOS HarmonyOS
x 4.41 4.61 4.61 4.61
# 参数
名称 类型 必填 默认值 兼容性 描述
options (result: RecorderManagerOnStopResult) => void 是 - - -
# RecorderManagerOnStopResult 的属性值
名称 类型 必备 默认值 兼容性 描述
tempFilePath string 是 -
录音文件的临时路径

# onFrameRecorded(options : (result : any) => void) : void;

已录制完指定帧大小的文件，会回调录音分片结果数据。如果设置了 frameSize ，则会回调此事件

# onFrameRecorded 兼容性
Web 微信小程序 Android iOS HarmonyOS
x 4.41 x x x
# 参数
名称 类型 必填 默认值 兼容性 描述
options (result: any) => void 是 - - -

# onError(options : (result : any) => void) : void;

录音错误事件, 会回调错误信息

# onError 兼容性
Web 微信小程序 Android iOS HarmonyOS
x 4.41 4.61 4.61 4.61
# 参数
名称 类型 必填 默认值 兼容性 描述
options (result: any) => void 是 - - -

# onResume(options : (result : any) => void) : void;

监听录音继续事件,App-Android平台在Android 7.0及以后版本支持

# onResume 兼容性
Web 微信小程序 Android 系统版本 Android iOS HarmonyOS
x 4.41 7.0 4.61 4.61 4.61
# 参数
名称 类型 必填 默认值 兼容性 描述
options (result: any) => void 是 - - -

# onInterruptionBegin(options : (result : any) => void) : void;

监听录音因为受到系统占用而被中断开始事件

# onInterruptionBegin 兼容性
Web 微信小程序 Android iOS HarmonyOS
x 4.41 4.61 4.61 4.61
# 参数
名称 类型 必填 默认值 兼容性 描述
options (result: any) => void 是 - - -

# onInterruptionEnd(options : (result : any) => void) : void;

监听录音中断结束事件

# onInterruptionEnd 兼容性
Web 微信小程序 Android iOS HarmonyOS
x 4.41 4.61 4.61 4.61
# 参数
名称 类型 必填 默认值 兼容性 描述
options (result: any) => void 是 - - -

# 参见

# 通用类型

# GeneralCallbackResult

名称 类型 必备 默认值 兼容性 描述
errMsg string 是 -
错误信息
本页导读
uni.getRecorderManager()
getRecorderManager 兼容性
返回值
RecorderManager 的方法
start(options : RecorderManagerStartOptions) : void;
pause() : void;
resume() : void;
stop() : void;
onStart(options : (result : any) => void) : void;
onPause(options : (result : any) => void) : void;
onStop(options : (result : RecorderManagerOnStopResult) => void) : void;
onFrameRecorded(options : (result : any) => void) : void;
onError(options : (result : any) => void) : void;
onResume(options : (result : any) => void) : void;
onInterruptionBegin(options : (result : any) => void) : void;
onInterruptionEnd(options : (result : any) => void) : void;
参见
通用类型
GeneralCallbackResult