云端录制概述
功能介绍
云端录制可通过服务端 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 | 查询录像 | 录制完成后,可获取录像文件信息。 |