音视频通话

云端录制

功能介绍

云端录制有两种模式:

模式 功能描述
单流模式 支持将房间内的部分或全部视频及音频直接转储成文件,各流独立生成音视频文件;服务器开销小;
合流模式 支持将房间内视频、屏幕共享、影音共享、白板、音频等混合录制成一个文件;服务器开销较大;

两种模式的一些特性对比:

对比项 单流模式 合流模式
开启方式 createCloudMixer 参数 CRCloudMixerCfgObj 的 mode 配置为 1。 createCloudMixer 参数 CRCloudMixerCfgObj 的 mode 配置为 0。
图像内容 房间内视频。
如果需要录制桌面,可以用桌面摄像头的方式。
请参见 CRCloudMixerCfgObj 中 videoFileCfg.subscribeVideos 的相关描述。
房间内视频、屏幕共享、影音共享、白板等。
在 CRCloudMixerCfgObj 中 videoFileCfg.layoutConfig 列表中添加 CRMixerContentObj。
内容布局 不支持。 支持自由布局。
layoutConfig 列表中靠前的 CRMixerContentObj 元素在图像底层。
CRMixerContentObj 中 left、top、width、height 可以控制位置和大小。
添加水印 不支持。
只能在源端视频侧添加水印。
可以自由添加时间戳、文本、图像等内容。
参见 CRMixerContentObj 中 type 的相关定义。
添加音频 可以在视频录像中添加自己或房间内所有人的声音。
参见 CRCloudMixerCfgObj 中 videoFileCfg.aStreamType 参数描述。
可以在视频录像中添加房间内所有人的声音,也可以添加指定人员列表的声音。
可以为两人通话场景的视频录像添加左右声道。
参见 CRCloudMixerCfgObj 中 videoFileCfg.aChannelType、aChannelContent 参数描述。
独立音频文件 可以为房间内指定人员或全部人员各生成一个独立的音频文件。
参见 CRCloudMixerCfgObj 中 audioFileCfg 参数描述。
可以为房间生成一个独立的音频文件。
可以为两人通话场景生成一个左右声道的音频文件。
参见 CRCloudMixerCfgObj 中 audioFileCfg 参数描述。
任务数量 只需要启一个录制任务,就可为房间内全部视频或指定视频列表各生成一个录像文件。 可以开启多个合流任务,每个合流任务生成一个录像文件。
录像质量 不支持。
只能通过调整源端发出图像质量来控制录像质量。
可以控制录像分辨率、帧率、码率等参数。
参见 CRCloudMixerCfgObj 中 videoFileCfg.vWidth、vHeight、vFps、vBps、vQP 参数描述。
更新内容 录制中可以调整录制的视频列表。 录制中可以修改图像内容、水印等,可以调整内容布局。
服务器开销 视频不重新编解码,CPU、内存开销小,磁盘 IO 开销与录制的视频个数和每个流的数据量相关。 录制内容将解码成图像,并按布局混图,再编码,CPU 开销大。
降低录像分辨率、录像帧率、减少录像内容能有效降低开销。
第三方存储 默认存储在 SDK 服务器上。
可以通过 CRCloudMixerCfgObj 的 storageConfig 参数将录像文件存到第三方存储中。
默认存储在 SDK 服务器上。
可以通过 CRCloudMixerCfgObj 的 storageConfig 参数将录像文件存到第三方存储中。

使用说明

本文主要以 SDK 端发起云端录制为例进行讲解,如果想由应用服务器来完成云端录制,可以参考以下 WEB API:

WEB API 开启云端录制
WEB API 停止云端录制
WEB API 更新云端录制
WEB API 录制任务状态回调
WEB API 录制事件回调
WEB API 录像文件查询

1.开通云端录制服务

  • 请确保您已成功 注册 账号。
  • 请联系商务为对应账号开通“云端录制服务”。

2.开始云端录制

  • 录制左右布局示例图:

左右布局示例图

  • 调用接口:
// 配置混图器,合流模式,录制尺寸 640×360,自定义布局:
// 左边为 usr1 的默认视频设备,右边为 usr2 的默认视频设备。
std::string mixerCfg = R"({
  "mode": 0,
  "videoFileCfg": {
    "vWidth": 640,
    "vHeight": 360,
    "mixedLayout": 1,
    "svrPathName": "xxxxxxx",
    "layoutConfig": [
      { "type": 0, "keepAspectRatio": 1, "left": 0,   "top": 90, "width": 320, "height": 180, "param": { "camid": "usr1.-1" } },
      { "type": 0, "keepAspectRatio": 1, "left": 320, "top": 90, "width": 320, "height": 180, "param": { "camid": "usr2.-1" } }
    ]
  }
})";

std::string rsltMixerID = g_sdkMain->getSDKMeeting().createCloudMixer("task1", mixerCfg.c_str());

可以多次调用createCloudMixer传入不同参数,同时开启多个云端录制。
如果录像需要保存到第三方云存储,请在 createCloudMixer 的参数 CRCloudMixerCfgObj 中添加 storageConfig 参数。

相关 API 请参考:

createCloudMixer

3.更新云端录制内容

  • 更新成画中画布局示例图:

画中画布局示例图

  • 接口调用:
// 混图器内容:画中画布局(底层 640×360,上层 160×90),
// 底层为 usr1 的默认视频设备,上层为 usr2 的默认视频设备。
std::string mixerCfg = R"({
  "videoFileCfg": {
    "layoutConfig": [
      { "type": 0, "keepAspectRatio": 1, "left": 0,   "top": 0,   "width": 640, "height": 360, "param": { "camid": "usr1.-1" } },
      { "type": 0, "keepAspectRatio": 1, "left": 475, "top": 265, "width": 160, "height": 90,  "param": { "camid": "usr2.-1" } }
    ]
  }
})";

CRVSDK_ERR_DEF err = g_sdkMain->getSDKMeeting().updateCloudMixerContent(m_mixerID, mixerCfg.c_str());
if (err != CRVSDKERR_NOERR)
{
    // 更新出错,按错误码进行处理
}

相关 API 请参考:

updateCloudMixerContent

4.停止云端录制

停止云端录制后,也会触发事件 notifyCloudMixerStateChanged。

  • 接口调用:
g_sdkMain->getSDKMeeting().destroyCloudMixer(m_mixerID);

相关 API 请参考:

destroyCloudMixer

5.云端录制回调通知

录制过程中会有录制状态变化事件、录制文件信息变化通知。在此可以实时获得录制状态、录制文件当前的时长、大小,以及录制异常等信息。

  • 回调通知:
// 云端录制状态变化通知
void DlgServerRecord::notifyCloudMixerStateChanged(const char* mixerID,
                                                   CRVSDK_MIXER_STATE state,
                                                   const char* exParam,
                                                   const char* operUserID)
{
  // 状态处理
  ...
}
//云端录制事件通知,包含文件录制信息,上传信息,错误告警
void DlgServerRecord::notifyCloudMixerEvent(const char* mixerID, CRVSDK_CLOUDMIXER_EVENT_TYPE eventType, const char* jsonStr)
{
  // 状态处理,文件时长、大小、上传进度等处理
}

相关 API 请参考:

notifyCloudMixerStateChanged

notifyCloudMixerEvent

6.获取录像

录像停止后,录像文件会开始上传到录像文件存储服务器中(可关注notifyCloudMixerEvent通知,得到上传完成事件)。

可以通过 WEB API 进行录像文件查询、下载和删除等处理。

也可以登录 管理后台,在管理页面上回放和下载录像:

recordMgr

如果将录像保存到第三方云存储上,请使用第三方提供的接口或管理页来获取。