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 |
扫码体验
请使用字节宿主APP扫码
代码示例
【代码示例 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
暂无
点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助