本地录制
功能介绍
用户可以对通讯过程进行录制并保存到终端设备,有以下特性:
- 录制画面可以根据业务场景自由拼接组合,包括本地摄像头、远端摄像头、远端共享的屏幕、影音播放、图片。支持同时启动多个录制。
- 录制格式支持mp4、ts、flv、aiv,如果选择了flv和ts两种格式,即使录制过程中程序出现异常了,崩溃之前的录像仍然可用。
- 对于金融双录等安全性要求高的特定领域,支持对录制的文件进行加密,录制后直接把录像传到标准http服务器、OSS或者SDK服务器。
- 本地加密过的录像只能通过SDK提供的播放器播放。
1. 创建混图器
录制文件时,可以根据业务需要,选择不同的录制布局。如下代码为创建左右布局的相关示例。
- 设置混图器配置
//混图器参数配置
MixerCfg* mixerCfg = [[MixerCfg alloc]init];
mixerCfg.fps = 15;
mixerCfg.dstResolution = CGSizeMake(848,480);
// 图像内容集合 - 创建左右布局的摄像头录制内容,
NSMutableArray<RecContentItem *> *contents = [NSMutableArray array];
//自己的摄像头(左边布局), 设置摄像头录制视频大小,由于左右布局, 宽度只有录制布局的一半
CGRect leftRect = CGRectMake(0, 0, mixerCfg.dstResolution.width/2, mixerCfg.dstResolution.height);
// 添加到内容列表
RecVideoContentItem *leftVideoItem = [[RecVideoContentItem alloc] initWithRect:leftRect userID:myUserID camID:-1];
[contents addObject:leftVideoItem];
//其他人的摄像头(右边布局)
RecVideoContentItem* rightVideoItem = [[RecVideoContentItem alloc] initWithRect:rightRect userID:otherUserID camID:-1];
// 添加到内容列表
[contents addObject:rightVideoItem];
MixerContent *recContent = [[MixerContent alloc]init];
recContent.contents = [contents copy];
//创建混图器
CRVIDEOSDK_ERR_DEF rslt = [[RTCMeeting shareInstance] createLocMixer:@"1" cfg:mixerCfg content:recContent];
if(rslt == CRVIDEOSDK_NOERR)
{
//创建成功
}
相关API请参考:
相关结构定义请参考:
2. 添加输出到录像文件
NSMutableArray<OutputCfg*> *outputCfgs = [NSMutableArray array];
OutputCfg* outputCfg = [[OutputCfg alloc]init];
[outputCfg setFileName:[PathUtil searchPathInCacheDir:[NSString stringWithFormat:@"RTCSDK/%d_iOS.mp4", self.meetInfo.ID]]];
[outputCfgs addObject:outputCfg];
self.currentRecordFileName = outputCfg.fileName;
MixerOutput *mixerOutput = [[MixerOutput alloc]init];
mixerOutput.outputs = outputCfgs;
//mixerID是创建混图器设置的id
rslt = [[RTCMeeting shareInstance] addLocMixer:mixerID outputs:mixerOutput];
if (rslt !== CRVIDEOSDK_NOERR) {
//启动成功
}
相关API请参考:
相关结构定义请参考:
3. 录像文件回调处理
在此可获得录像文件的时长、大小、录像文件异常等信息
-(void)locMixerOutputInfo:(NSString*)mixerID nameUrl:(NSString*)nameUrl outputInfo:(OutputInfo*)outputInfo
{
if ( outputInfo.state==OUTPUT_ERR ){
//录像文件出错,info.errCode中有错误原因
}
}
相关API请参考:
4. 更新图像内容
- 画中画布局示例图

- 接口调用:
// 图像内容集合 - 创建画中画布局的摄像头录制内容,
NSMutableArray<RecContentItem *> *contents = [NSMutableArray array];
//自己的摄像头(充满布局)
CGRect leftRect = CGRectMake(0, 0, mixerCfg.dstResolution.width, mixerCfg.dstResolution.height);
// 添加到内容列表
RecVideoContentItem *leftVideoItem = [[RecVideoContentItem alloc] initWithRect:leftRect userID:myUserID camID:-1];
[contents addObject:leftVideoItem];
//其他人的摄像头(右边布局)
RecVideoContentItem* rightVideoItem = [[RecVideoContentItem alloc] initWithRect:rightRect userID:otherUserID camID:-1];
// 添加到内容列表
[contents addObject:rightVideoItem];
MixerContent *recContent = [[MixerContent alloc]init];
recContent.contents = [contents copy];
// 更新图像内容
CRVIDEOSDK_ERR_DEF rslt = [[RTCMeeting shareInstance] updateLocMixerContent:@"1" content:contents];
if (rslt == CRVIDEOSDK_NOERR) {
//更新配置成功
}
相关API请参考:
5. 结束录制文件
//销毁混图器, 输出自动结束
[[RTCMeeting shareInstance] destroyLocMixer:@"1"];
相关API请参考: