音视频通话

本地录制

功能介绍

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

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

1. 创建混图器

  • 左右布局示例图

左右布局示例图

  • 接口调用:
//混图器参数配置
MixerCfg mixerCfg = new MixerCfg();
mixerCfg.frameRate = 15;
mixerCfg.dstResolution = new Size(864, 480);

// 图像内容集合 - 创建左右布局的摄像头录制内容
ArrayList<MixerCotent> contents = new ArrayList<MixerCotent>();

//自己的摄像头(左边布局), 设置摄像头录制视频大小,由于左右布局, 宽度只有录制布局的一半
Rect leftRect = new Rect(0, 0, mixerCfg.dstResolution.width/2, mixerCfg.dstResolution.height);
MixerCotent leftVideoItem = MixerCotent.createVideoContent(myUserID, (short)-1, leftRect);
// 添加到内容列表
contents.add(leftVideoItem);

//其他人的摄像头(右边布局)
Rect rightRect = new Rect(mixerCfg.dstResolution.width/2, 0, mixerCfg.dstResolution.width, mixerCfg.dstResolution.height);
MixerCotent rightVideoItem = MixerCotent.createVideoContent(otherUserID, (short)-1, rightRect);
// 添加到内容列表
contents.add(rightVideoItem);

// 创建混图器, 设置混图器编号为1
CRVIDEOSDK_ERR_DEF errCode = RTCMeeting.getInstance().createLocMixer("1", mixerCfg, contents);
if(errCode == CRVIDEOSDK_ERR_DEF.CRVIDEOSDK_NOERR){
    //创建成功
}

相关API请参考:

相关结构定义请参考:

2. 添加输出到录像文件

ArrayList<MixerOutPutCfg> cfgs = new ArrayList<MixerOutPutCfg>();

MixerOutPutCfg outputCfg = new MixerOutPutCfg();
//  设置混图输出类型为录像文件
outputCfg.type = MIXER_OUTPUT_TYPE.MIXOT_FILE; 
// 录制文件名称
outputCfg.fileName = "/sdcard/_Android.mp4";
cfgs.add(outputCfg);

CRVIDEOSDK_ERR_DEF errCode = RTCMeeting.getInstance().addLocMixerOutput("1", cfgs);
if (errCode == CRVIDEOSDK_ERR_DEF.CRVIDEOSDK_NOERR) {
    //启动成功
}

相关API请参考:

相关结构定义请参考:

3. 录像回调处理

在此可获得录像文件的时长、大小、录像文件异常等信息

void locMixerOutputInfo(String mixerID, String nameOrUrl, MixerOutputInfo info){
    if ( info.state==MIXER_OUTPUT_STATE.OUTPUT_ERR ){
        //录像文件出错,info.errCode中有错误原因
    }
}

相关API请参考:

4. 更新图像内容

  • 画中画布局示例图

画中画布局示例图

  • 接口调用:
// 图像内容集合 - 创建画中画布局的摄像头录制内容, 
ArrayList<MixerCotent> contents = new ArrayList<MixerCotent>();

//自己的摄像头(充满布局)
Rect bigRect = new Rect(0, 0, mixerCfg.dstResolution.width, mixerCfg.dstResolution.height)
MixerCotent bigVideoItem = MixerCotent.createVideoContent(myUserID, (short)-1, bigRect);
// 添加到内容列表
contents.add(leftVideoItem);

//其他人的摄像头(部分布局)
Rect smallRect = new Rect(0, 0, mixerCfg.dstResolution.width/5, mixerCfg.dstResolution.height/5)
MixerCotent rightVideoItem = MixerCotent.createVideoContent(otherUserID, (short)-1, smallRect);
// 添加到内容列表
contents.add(rightVideoItem);

// 更新图像内容
CRVIDEOSDK_ERR_DEF errCode = RTCMeeting.getInstance().updateLocMixerContent(“1”, contents);
if (errCode == CRVIDEOSDK_ERR_DEF.CRVIDEOSDK_NOERR) {
    //更新配置成功
}

相关API请参考:

5. 结束录制

//销毁混图器, 输出自动结束
RTCMeeting.getInstance().destroyLocMixer("1");

相关API请参考: