音视频通话

本地录制

功能介绍

用户可以对通讯过程进行录制并保存到终端设备,有以下特性:

  • 录制画面可以根据业务场景自由拼接组合,包括本地摄像头、远端摄像头、远端共享的屏幕、影音播放、图片。支持同时启动多个录制。
  • 录制格式支持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请参考: