本地录制
功能介绍
用户可以对通讯过程进行录制并保存到终端设备,有以下特性:
- 录制画面可以根据业务场景自由拼接组合,包括本地摄像头、远端摄像头、远端共享的屏幕、影音播放、图片。支持同时启动多个录制。
- 录制格式支持mp4、ts、flv、aiv, mp3,如果选择了flv和ts两种格式,即使录制过程中程序出现异常了,崩溃之前的录像仍然可用。
- 对于金融双录等安全性要求高的特定领域,支持对录制的文件进行加密,录制后直接把录像传到标准http服务器、OSS或者SDK服务器。
- 本地加密过的录像只能通过SDK提供的播放器播放。
1. 创建混图器
- 左右布局示例图

- 接口调用:
const mixerID = '1'; //混图器唯一标识
//混图器参数配置
const mixerCfgObj = {
width: 1280,
height: 720,
frameRate: 15,
bitRate: 1000000,
defaultQP: 26,
gop: 15,
}
const mixerContentsObj = [{
type: 0,
top: 0,
left: 0,
width: 640,
height: 720,
param: {
camid: "Usr1.-1"
}
}, {
type: 0,
top: 0,
left: 640,
width: 640,
height: 720,
param: {
camid: "Usr2.-1"
}
}]
// 创建混图器, 设置混图器编号为1
const sdkErr = rtcsdk.createLocMixer(mixerID, JSON.stringify(mixerCfgObj), JSON.stringify(mixerContentsObj));
if(sdkErr !== 0){
//创建失败
return;
}
相关API请参考:
相关结构定义请参考:
2. 添加输出到录像文件
const fileName = "/sdcard/2023-11-27_13-47-41_Electron_73542046.mp4";
const MixerOutputObj = [];
MixerOutputObj.push({
type: 0,
fileName: fileName
});
const sdkErr = rtcsdk.addLocMixerOutput(mixerID, JSON.stringify(MixerOutputObj));
if (sdkErr !== 0) {
//启动失败
return;
}
相关API请参考:
相关结构定义请参考:
3. 录像回调处理
在此可获得录像文件的时长、大小、录像文件异常等信息
rtcsdk.on("notifyLocMixerOutputInfo", (mixerID, nameOrUrl, outputInfo) => {
if (outputInfo.state === 3){
//录像文件出错,errCode中有错误原因
}
})
相关API请参考:
4. 更新图像内容
- 画中画布局示例图

- 接口调用:
// 录制参数列表中,越靠后的元素会覆盖之前的元素
const mixerContents = [{
//大窗的视频
type: 0,
top: 0,
left: 0,
width: 1280,
height: 720,
param: {
camid: "Usr2.-1"
}
}, {
//小窗口视频
type: 0,
top: 1280 - 256,
left: 720 - 144,
width: 256,
height: 144,
param: {
camid: "Usr1.-1"
}
}]
// 更新混图器
const sdkErr = rtcsdk.updateLocMixerContent(mixerID, JSON.stringify(mixerContents));
if (sdkErr !== 0) {
//更新配置失败
return;
}
相关API请参考:
5. 结束录制
//停止混图器输出,录制文件将自动保存
rtcsdk.rmLocMixerOutput(mixerID, [fileName])
//销毁混图器
rtcsdk.destroyLocMixer(mixerID);
相关API请参考: