云端录制
功能介绍
云端录制有两种模式:
| 模式 | 功能描述 |
|---|---|
| 单流模式 | 支持将房间内的部分或全部视频及音频直接转储成文件,各流独立生成音视频文件;服务器开销小; |
| 合流模式 | 支持将房间内视频、屏幕共享、影音共享、白板、音频等混合录制成一个文件;服务器开销较大; |
两种模式的一些特性对比:
| 对比项 | 单流模式 | 合流模式 |
|---|---|---|
| 开启方式 | 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 请参考: