RecorderManager.start

基础库版本 1.0.0 开始支持。

开始录音。该方法需要用户授权方可调用，详细信息可参考用户授权。

语法

RecorderManager.start([options])

参数说明

options 为 object 类型，属性如下：

属性名	类型	默认值	必填	说明	最低支持版本
duration	number	60000	否	录音自动完成时长，单位 ms	1.0.0
sampleRate	number	8000	否	采样率	1.0.0
numberOfChannels	number	1	否	录音通道数	1.0.0
encodeBitRate	number	48000	否	码率	1.0.0
frameSize	number	8000	否	帧大小，单位 KB。如果设置了值，那么每当录音内容达到帧大小时会通过 RecorderManager.onFrameRecorded 返回内容	1.0.0

options.sampleRate 的合法值

值	说明
8000	8000 采样率
11025	11025 采样率
12000	12000 采样率
16000	16000 采样率
22050	22050 采样率
24000	24000 采样率
32000	32000 采样率
44100	44100 采样率
48000	48000 采样率

options.numberOfChannels 的合法值

值	说明
1	1 个通道
2	2 个通道

`sampleRate` 和 `encodeBitRate` 的对应关系

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

采样率	编码码率
8000	16000 ~ 48000
11025	16000 ~ 48000
12000	24000 ~ 64000
16000	24000 ~ 96000
22050	32000 ~ 128000
24000	32000 ~ 128000
32000	48000 ~ 192000
44100	64000 ~ 320000
48000	64000 ~ 320000

代码示例

开发者工具中预览

【代码示例 1】：无参数示例

预期表现：正常启动录音，录音时长等参数为默认值。

const recorderManager = tt.getRecorderManager();
recorderManager.start(); // 所有参数为默认值
tt.showToast({ title: "点击了开始录音，参数为默认值" });

【代码示例 2】：不设置 frameSize 参数示例

预期表现：正常启动录音，无 onFrameRecorded 回调。

const recorderManager = tt.getRecorderManager();
const options = {
  duration: 1000,
  sampleRate: 12000,
  numberOfChannels: 1,
  encodeBitRate: 25000,
  frameSize: 100,
};
recorderManager.start(options);
tt.showToast({ title: "点击了开始录音" });

【代码示例 3】：设置 frameSize 示例

预期表现：正常启动录音，达到指定帧大小后在 onFrameRecorded 回调中输出帧数据，若指定帧大小大于整条语音，则在最后一帧输出，可根据 isLastFrame 判断是否是最后一帧。

const recorderManager = tt.getRecorderManager();
const options = {
  duration: 60000,
  sampleRate: 12000,
  numberOfChannels: 1,
  encodeBitRate: 25000,
  frameSize: 100,
};
recorderManager.start(options);
tt.showToast({ title: "点击了开始录音" });
recorderManager.onFrameRecorded((frame) => {
  if (frame.isLastFrame) {
    tt.showToast({ title: "录音结束" });
  }
});

Bug & Tip

暂无

点击纠错

该文档是否对你的开发有所帮助？

有帮助

没帮助