Skip to content

RecorderManager.start ​

JS
RecorderManager.start(Object options)

开始录音

异步操作,录音成功开始后触发 onStart 回调。

参数

  • Object options: 录音配置参数,具体的属性见下表

options 的属性说明:

属性键值类型默认值是否必填说明
durationnumber60000否录音的最大时长,单位 ms。最大值 600000 (10 分钟),超过上限自动钳位。录音到达 duration 后自动停止并触发 onStop
sampleRatenumber8000否采样率 (Hz),合法值: 8000, 11025, 12000, 16000, 22050, 24000, 32000, 44100, 48000
numberOfChannelsnumber2否录音通道数,合法值: 1 (单声道), 2 (双声道)。不合法值自动修正为 2
encodeBitRatenumber48000否编码码率 (bps),仅 format 为 "aac" 或 "mp3" 时有效。有效范围取决于 sampleRate,详见下方约束表
formatstring"aac"否编码格式,合法值: "aac", "mp3", "wav", "PCM"
frameSizenumber否指定帧大小,单位 KB。设置后触发 onFrameRecorded 回调,不设置或设置为 0 则不触发
audioSourcestring"auto"否音频输入源,合法值: "auto", "buildInMic", "headsetMic", "mic", "camcorder", "voiceCommunication", "voiceRecognition"。不合法值自动修正为 "auto"

sampleRate 与 encodeBitRate 约束表:

sampleRate (Hz)encodeBitRate 有效范围 (bps)
800016000 ~ 48000
1102516000 ~ 48000
1200024000 ~ 64000
1600024000 ~ 96000
2205032000 ~ 128000
2400032000 ~ 128000
3200048000 ~ 192000
4410064000 ~ 320000
4800064000 ~ 320000

sampleRate 不在合法值列表内,或 encodeBitRate 超出对应采样率的有效范围时,start 将失败并触发 onError。当 format 为 "wav" 或 "PCM" 时,encodeBitRate 参数无意义 (码率由采样率、声道数、位深直接决定),此时忽略该参数,不做校验。

format 说明:

format 值输出文件扩展名说明
"aac".aacAAC 编码,ADTS 封装
"mp3".mp3MP3 编码
"wav".wavWAV 容器 + PCM 原始数据,文件较大
"PCM".pcm裸 PCM 原始数据,无文件头,文件较大