API

操作相关

start()

开始录音。

• 返回: Promise。

recorder.start().then(() => {
    // 开始录音
}, (error) => {
    // 出错了
    console.log(`${error.name} : ${error.message}`);
});

pause()

录音暂停。

• 返回: void

recorder.pause();

resume()

继续录音。

• 返回: void。

recorder.resume()

stop()

结束录音。

• 返回: void。

recorder.stop();

play()

录音播放。

• 返回: void。

recorder.play();

getPlayTime()

获取音频已经播的时长。

• 返回: number。

recorder.getPlayTime();

pausePlay()

暂停录音播放。

• 返回: void。

recorder.pausePlay();

resumePlay()

恢复录音播发。

• 返回: void。

recorder.resumePlay();

stopPlay()

停止播放。

• 返回: void。

recorder.stopPlay();

destroy()

销毁实例。

• 返回: Promise。

// 销毁录音实例，置为null释放资源，fn为回调函数，
recorder.destroy().then(function() {
    recorder = null;
});

音频数据

录音结束，获取取录音数据

getPCMBlob()

获取 PCM 数据，在录音结束后使用。

• 返回: Blob

注：使用该方法会默认调用 stop() 方法。

recorder.getPCMBlob();

getWAVBlob()

获取 WAV 数据，在录音结束后使用

• 返回: Blob

注：使用该方法会默认调用 stop() 方法。

recorder.getWAVBlob();

getChannelData()

获取左声道和右声道音频数据。

recorder.getChannelData();

录音结束，下载录音文件

downloadPCM([ filename ])

下载 PCM 格式

• fileName String 重命名文件
• 返回: Blob

注：使用该方法会默认调用 stop() 方法。

recorder.downloadPCM(fileName ?);

downloadWAV([ filename ])

下载 WAV 格式

• fileName String 重命名文件
• 返回: Blob

注：使用该方法会默认调用 stop() 方法。

录音中，获取录音数据

(0.x版本中生效，最新目前不支持)

该方式为边录边转换，建议在 compiling 为 true 时使用。

getWholeData()

获取已经录音的所有数据。若没有开启边录边转(compiling为false)，则返回是空数组。

• 返回: Array, 数组中是DataView数据

定时获取所有数据：

setInterval(() => {
    recorder.getWholeData();
}, 1000)

getNextData()

获取前一次 getNextData() 之后的数据。若没有开启边录边转(compiling为false)，则返回是空数组。

• 返回: Array, 数组中是DataView数据

定时获取新增数据：

setInterval(() => {
    recorder.getNextData();
}, 1000)
// 实时录音，则可将该数据返回给服务端。

录音波形显示

getRecordAnalyseData()

返回的是一个1024长的，0-255大小的Uint8Array类型。用户可以根据这些数据自定义录音波形。此接口获取的是录音时的。

let dataArray = recorder.getRecordAnalyseData();

getPlayAnalyseData()

返回数据同 getRecordAnalyseData()，该方法获取的是播放时的。

let dataArray = recorder.getPlayAnalyseData();

播放外部

Player.play(blob)

播放外部音频，格式由浏览器的audio支持的类型决定。

Player.play(/* 放入arraybuffer数据 */);

其他

录音权限

未给予录音权限的页面在开始录音时需要再次点击允许录音，才能真正地录音，存在丢失开始这一段录音的情况，增加方法以便用户提前获取麦克风权限。

getPermission()

获取麦克风权限。

• 返回：promise。

Recorder.getPermission().then(() => {
    console.log('给权限了');
}, (error) => {
    console.log(`${error.name} : ${error.message}`);
});

此处then回调与start的一致。