本地录制
功能介绍
用户可以对通讯过程进行录制并保存到终端设备。
- 录制画面可以根据业务场景自由拼接组合,包括本地摄像头、远端摄像头、远端共享的屏幕、影音播放、图片。支持同时启动多个录制。
- 录制格式支持 mp4、ts、flv,如果选择了 flv 和 ts 两种格式,即使录制过程中程序出现异常了,崩溃之前的录像仍然可用。
- 对于金融双录等安全性要求高的特定领域,支持对录制的文件进行加密,录制后直接把录像传到标准 http 服务器、OSS 或者SDK服务器。
- 本地加密过的录像只能通过 SDK 提供的播放器播放。
1. 创建混图器
如下代码为创建自己摄像头和左上角叠加一个时间戳的相关示例。
// 混图器唯一标识
final String mixerId = "1";
// 混图器参数配置
MixerCfg cfg = MixerCfg(
width: 360,
height: 640,
frameRate: 15,
bitRate: 500000,
defaultQP: 26,
gop: 15);
// 混图器内容
List<MixerCotentRect> mcr = [
// 混视频
MixerCotentRect(
userId: myUserId,
camId: -1,
type: MIXER_VCONTENT_TYPE.MIXVTP_VIDEO,
top: 0,
left: 0,
width: cfg.width,
height: cfg.height),
// 混时间戳
MixerCotentRect(
left: 0,
top: 0,
width: 175,
height: 32,
type: MIXER_VCONTENT_TYPE.MIXVTP_TIMESTAMP)
]
// 创建混图器
RtcSDK.recordManager.createLocMixer(mixerId, cfg, mcr).then((int sdkErr) {
if (sdkErr == 0) {
// 创建混图器成功
} else {
// 创建混图器失败
}
});
相关 API 请参考:
相关结构定义请参考:
2. 添加输出到录像文件
// 录制文件名称
const String fileName = = "/sdcard/_Android.mp4";
// 输出配置
MixerOutPutCfg mixerOutPutCfg = MixerOutPutCfg(
type: MIXER_OUTPUT_TYPE.MIXOT_FILE,
fileName: fileName
);
List<MixerOutPutCfg> mixerOutPutCfgs = [
mixerOutPutCfg
];
RtcSDK.recordManager.addLocMixerOutput(mixerId, mixerOutPutCfgs).then((int sdkErr) {
if (sdkErr == 0) {
// 添加输出到录像文件成功
} else {
// 添加输出到录像文件失败
}
});
相关 API 请参考:
相关结构定义请参考:
3. 录像回调处理
在此可获得录像文件的时长、大小、录像文件异常等信息
RtcSDK.recordManager.setListener(RecordListener(
onLocMixerOutputInfo: locMixerOutputInfo,
onLocMixerStateChanged: locMixerStateChanged,
onNotifyRecordFileStateChanged: notifyRecordFileStateChanged,
onNotifyRecordFileUploadProgress: notifyRecordFileUploadProgress
));
// 在此可获得录像文件的时长、大小、录像文件异常等信息
locMixerOutputInfo(MixerOutputInfo mixerOutputInfo) {}
相关 API 请参考:
4. 更新图像内容
- 更新混图器
// 根据混图器ID,更新对应的内容
RtcSDK.recordManager.updateLocMixerContent(mixerId, mcr).then((int sdkErr) {
if (sdkErr == 0) {
// 更新混图器成功
} else {
// 更新混图器失败
}
});
相关 API 请参考:
5. 结束录制
//销毁混图器,输出自动结束
RtcSDK.recordManager.destroyLocMixer(mixerId).then((int sdkErr) {
if (sdkErr == 0) {
// 销毁混图器成功
} else {
// 销毁混图器失败
}
});
相关 API 请参考: