音视频通话

云端录制概述

功能介绍

云端录制可通过服务端 API 接口实现,主要包括以下功能点:

功能 说明
录制内容 支持对房间内的实时音视频进行录制,包括通话过程中的音频、视频以及互动画面(如屏幕共享、白板、影音等)。
录制模式 支持单流录制和合流录制。
• 单流录制:支持将房间内的部分或全部视频及音频直接转储成文件,各流独立生成音视频文件,服务器开销小。
• 合流录制:支持将房间内视频、屏幕共享、影音共享、白板、音频等混合录制成一个文件,服务器开销较大。
录制媒体类型 支持仅录制音频、仅录制视频或同时录制音频和视频,可按业务场景选择。

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

对比项 单流模式 合流模式
开启方式 在开启接口中设置 cfg.mode = 1。
参见 Cfg.mode。
在开启接口中设置 cfg.mode = 0。
参见 Cfg.mode。
图像内容 录制摄像头视频流,可按订阅列表输出独立文件。
参见 VideoFileCfg.subscribeVideos。
可录制摄像头、屏幕共享、影音共享、白板等内容。
参见 VideoFileCfg.layoutConfig。
内容布局 不支持。 支持自定义布局。
参见 layoutConfig、更新云端录制。
添加水印 不支持。
只能在源端视频侧添加水印。
支持通过布局叠加时间戳、文本、图像等元素。
参见 layoutConfig.type。
添加音频 可在音频文件中添加本人音频或房间全员音频。
参见 VideoFileCfg.aStreamType。
可以在音频文件中添加房间内所有人的声音,也可以添加指定人员列表的声音。
可以为两人通话场景的视频录像添加左右声道。
参见 VideoFileCfg.aChannelType/aChannelContent。
独立音频文件 可以为房间内指定人员或全部人员各生成一个独立的音频文件。
参见 AudioFileCfg.subscribeAudios。
可以为房间生成一个独立的音频文件。
可以为两人通话场景生成一个左右声道的音频文件。
参见 AudioFileCfg。
任务数量 只需要启动一个录制任务,就可为房间内全部视频或指定视频列表各生成一个录像文件。 可以开启多个合流任务,每个合流任务生成一个录像文件。
录像质量 不支持。
只能通过调整源端发出图像质量来控制录像质量。
支持设置分辨率、帧率、码率、质量参数。
参见 VideoFileCfg.vWidth/vHeight/vFps/vBps/vQP。
更新内容 录制中可以调整订阅名单、推流配置,也可新增录制文件。
参见 更新云端录制。
支持在录制中更新输出文件、布局内容,也可新增录制文件。
参见 更新云端录制。
服务器开销 视频不重新编解码,CPU、内存开销小,磁盘 IO 开销与录制的视频个数和每个流的数据量相关。 录制内容将解码成图像,并按布局混图,再编码,CPU 开销大。
降低录像分辨率、录像帧率、减少录像内容能有效降低开销。

实现流程

云端录制按以下步骤接入:

步骤序号 参考文档 步骤说明
1 开通云端录制 • 请确保您已成功 注册 账号。
• 请联系商务为对应账号开通云端录制服务。
• 开启回调服务,以接收云端录制相关事件。参见 回调服务
2 开启云端录制 • 服务端调用接口创建录制任务,传入房间号、录制模式、媒体参数等配置。
• 接口调用成功后,请保存任务 ID,用于后续查询、更新或停止任务。
3 查询云端录制(可选) 查询云端录制任务和录制配置。
4 更新云端录制(可选) 录制过程中可按需更新订阅名单、布局、输出文件等配置。
5 停止云端录制 调用接口结束录制任务。
6 录制事件通知 录制过程中,通过状态变化事件和文件信息通知,实时获取录制状态及文件处理结果。
7 查询录像 录制完成后,可获取录像文件信息。