实现云端录制

更新时间：2024-03-18 17:35

1 接入流程

ZEGO 云端录制支持服务端 API，无需集成 SDK，直接通过 http 网络请求即可轻松开始云端录制。

开通云端录制服务前，请确保您已完成以下准备工作：

拥有一个已接入 ZEGO 实时音视频 SDK 的应用。
开通第三方云存储服务，目前支持 Amazon S3、阿里云 OSS、腾讯云 COS、七牛云 Kodo、阿里云 Vod（支持 MP4、 FLV 格式）、腾讯云 Vod、华为云 OBS、谷歌云 Cloud Storage、移动云 EOS。

云端录制功能不是默认开启的，使用前请在 ZEGO 控制台自助开通（开通步骤请参考项目管理 - 服务配置中的“云端录制”），或联系 ZEGO 技术支持开通。

以下为实现云端录制需要调用的 API 时序图：

调用 StartRecord 方法并设置房间号即可进入该房间进行录制，请求成功会返回对应的录制 TaskId，该 Id 是整个录制周期的唯一标识，将作为调用后续方法的请求参数。

调用所有接口都需要带上公共参数，详见调用方式，之后不再赘述。

录制过程中可以多次调用 DescribeRecordStatus 方法查询录制状态，在返回的响应中可以获取到录制状态及文件上传地址等信息。

混流录制过程中可以多次调用 UpdateLayout 方法更新混流布局，详情请参考设置混流布局。

白板录制过程中可以多次调用 UpdateWhiteboard 方法更新白板 Id，详情请参考白板录制。

调用 StopRecord 方法停止录制。

录制任务停止后，录制文件会上传至预先指定的第三方云存储。调用 DescribeRecordStatus 方法，通过返回的参数可以及时查看上传进度。

录制文件上传结束后，云端录制会回调通知到开通服务时指定的回调地址。

录制文件名包含 StreamId 和开始录制时间戳等信息，详情请参考 StartRecord 方法的 OutputFileRule 参数。