音视频通话

云端录制

功能介绍

云端录制有两种模式:

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

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

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

使用说明

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

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

1.开通云端录制服务

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

2. 开始云端录制

如下代码为创建自己摄像头和左上角叠加一个时间戳的相关示例。

    // 实例化一个云端混图器配置
    CloudMixerCfg cloudMixerCfg = CloudMixerCfg(mode: CLOUDMIXER_MODE.CONFLUENCE);

    // 混流的
    List<MutiMixerContent> mutiMixerContents = [
      MutiMixerContent(
        width: mixerWidth,
        height: mixerHeight,
        left: 0,
        top: 0,
        type: MIXER_VCONTENT_TYPE.MIXVTP_VIDEO,
        keepAspectRatio: KEEP_ASPECT_RATIO.KEEP,
        mutiMixerContentParams:
            MutiMixerContentParams(camid: "${rtcLogic.userID}.-1"),
      ),
      MutiMixerContent.timestamp(
        left: 0,
        top: 0,
        width: 175,
        height: 32,
        keepAspectRatio: KEEP_ASPECT_RATIO.KEEP,
      ), // 混时间戳
    ];
    cloudMixerCfg.videoFileCfg = CloudMixerVideoFileCfg.confluence(
      svrPathName: 'xx.mp4',
      vWidth: 480,
      vHeight: 720,
      layoutConfig: mutiMixerContents,
    );

    // 单流的,mode得改成单流
    cloudMixerCfg.mode = CLOUDMIXER_MODE.SINGLE;
    cloudMixerCfg.audioFileCfg = CloudMixerAudioFileCfg.single(
      svrPath: 'xxx/',
      svrFileNameSuffix: '.mp3',
      subscribeAudios: ["_cr_all_"],
    );
    cloudMixerCfg.videoFileCfg = CloudMixerVideoFileCfg.single(
      svrPath: 'xxx/',
      svrFileNameSuffix: '.mp4',
      subscribeVideos: ["_cr_all_"],
      aStreamType: 1,
    );

    // 开始云端录制
    String mixerId = await RtcSDK.recordManager.createCloudMixer(cloudMixerCfg);

3. 云端录制文件信息变化通知

  RtcSDK.recordManager.setListener(RecordListener(
    onCreateCloudMixerFailed: createCloudMixerFailed, // 启动云端录制、云端直播失败通知
    onCloudMixerStateChanged: cloudMixerStateChanged, // 云端录制、云端直播状态变化通知
    onCloudMixerInfoChanged: cloudMixerInfoChanged, // 云端录制、云端直播配置变化通知
    onCloudMixerOutputInfoChanged:
        (MixerOutputInfo mixerOutputInfo) {}, // 云端录制文件、云端直播输出变化通知
  ));

相关 API 请参考:

4. 更新云端录制内容

RtcSDK.recordManager.updateCloudMixerContent(mixerId, cloudMixerCfg);

相关 API 请参考:

5. 获取云端录制状态


//获取云端录制状态
CloudMixerInfo info = await RtcSDK.recordManager.getCloudMixerInfo();

相关 API 请参考:

相关结构定义请参考:

6.停止云端录制

停止云端录制,也会触发事件onCloudMixerStateChanged

  • 接口调用:
RtcSDK.recordManager.destroyCloudMixer();

相关 API 请参考: