微信小程序API 录音·录音管理器

RecorderManager

全局唯一的录音管理器

方法：

RecorderManager.onError(function callback)

监听录音错误事件

参数

function callback

录音错误事件的回调函数

参数

Object res

RecorderManager.onFrameRecorded(function callback)

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

参数

function callback

已录制完指定帧大小的文件事件的兼容处理。

参数

Object res

RecorderManager.onInterruptionBegin(function callback)

基础库 2.3.0 开始支持，低版本需做兼容处理。

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

参数

function callback

录音因为受到系统占用而被中断开始事件的回调函数

RecorderManager.onInterruptionEnd(function callback)

基础库 2.3.0 开始支持，低版本需做兼容处理。

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

参数

function callback

录音中断结束事件的回调函数

RecorderManager.onPause(function callback)

监听录音暂停事件

参数

function callback

录音暂停事件的回调函数

RecorderManager.onResume(function callback)

监听录音继续事件

参数

function callback

录音继续事件的回调函数

RecorderManager.onStart(function callback)

监听录音开始事件

参数

function callback

录音开始事件的回调函数

RecorderManager.onStop(function callback)

监听录音结束事件

参数

function callback

录音结束事件的回调函数

参数

Object res

RecorderManager.pause()

暂停录音

RecorderManager.resume()

继续录音

RecorderManager.start(Object object)

开始录音

参数

Object object

object.sampleRate 的合法值

object.numberOfChannels 的合法值

object.format 的合法值

object.audioSource 的合法值

采样率与编码码率限制

每种采样率有对应的编码码率范围有效值，设置不合法的采样率或编码码率会导致录音失败，具体对应关系如下表。

RecorderManager.stop()

停止录音

示例代码

const recorderManager = wx.getRecorderManager()

recorderManager.onStart(() => {
  console.log('recorder start')
})
recorderManager.onPause(() => {
  console.log('recorder pause')
})
recorderManager.onStop((res) => {
  console.log('recorder stop', res)
  const { tempFilePath } = res
})
recorderManager.onFrameRecorded((res) => {
  const { frameBuffer } = res
  console.log('frameBuffer.byteLength', frameBuffer.byteLength)
})

const options = {
  duration: 10000,
  sampleRate: 44100,
  numberOfChannels: 1,
  encodeBitRate: 192000,
  format: 'aac',
  frameSize: 50
}

recorderManager.start(options)