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

RecorderManager

全局唯一的錄音管理器

方法：

RecorderManager.onError(function callback)

監(jiān)聽錄音錯(cuò)誤事件

參數(shù)

function callback

錄音錯(cuò)誤事件的回調(diào)函數(shù)

參數(shù)

Object res

RecorderManager.onFrameRecorded(function callback)

監(jiān)聽已錄制完指定幀大小的文件事件。如果設(shè)置了 frameSize，則會(huì)回調(diào)此事件。

參數(shù)

function callback

已錄制完指定幀大小的文件事件的兼容處理。

參數(shù)

Object res

RecorderManager.onInterruptionBegin(function callback)

基礎(chǔ)庫 2.3.0 開始支持，低版本需做兼容處理。

監(jiān)聽錄音因?yàn)槭艿较到y(tǒng)占用而被中斷開始事件。以下場(chǎng)景會(huì)觸發(fā)此事件：微信語音聊天、微信視頻聊天。此事件觸發(fā)后，錄音會(huì)被暫停。pause 事件在此事件后觸發(fā)

參數(shù)

function callback

錄音因?yàn)槭艿较到y(tǒng)占用而被中斷開始事件的回調(diào)函數(shù)

RecorderManager.onInterruptionEnd(function callback)

基礎(chǔ)庫 2.3.0 開始支持，低版本需做兼容處理。

監(jiān)聽錄音中斷結(jié)束事件。在收到 interruptionBegin 事件之后，小程序內(nèi)所有錄音會(huì)暫停，收到此事件之后才可再次錄音成功。

參數(shù)

function callback

錄音中斷結(jié)束事件的回調(diào)函數(shù)

RecorderManager.onPause(function callback)

監(jiān)聽錄音暫停事件

參數(shù)

function callback

錄音暫停事件的回調(diào)函數(shù)

RecorderManager.onResume(function callback)

監(jiān)聽錄音繼續(xù)事件

參數(shù)

function callback

錄音繼續(xù)事件的回調(diào)函數(shù)

RecorderManager.onStart(function callback)

監(jiān)聽錄音開始事件

參數(shù)

function callback

錄音開始事件的回調(diào)函數(shù)

RecorderManager.onStop(function callback)

監(jiān)聽錄音結(jié)束事件

參數(shù)

function callback

錄音結(jié)束事件的回調(diào)函數(shù)

參數(shù)

Object res

RecorderManager.pause()

暫停錄音

RecorderManager.resume()

繼續(xù)錄音

RecorderManager.start(Object object)

開始錄音

參數(shù)

Object object

object.sampleRate 的合法值

object.numberOfChannels 的合法值

object.format 的合法值

object.audioSource 的合法值

采樣率與編碼碼率限制

每種采樣率有對(duì)應(yīng)的編碼碼率范圍有效值，設(shè)置不合法的采樣率或編碼碼率會(huì)導(dǎo)致錄音失敗，具體對(duì)應(yīng)關(guān)系如下表。

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)