云端录制
  • 产品简介
    • 概述
    • 发布日志
    • 计费说明
  • 快速开始
    • 实现云端录制
  • 基础功能
  • 服务端 API v2
  • 常见问题

实现云端录制

更新时间:2022-09-06 19:00

1 接入流程

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

/Pics/Common/CloudRecord/FastStart/CloudRecordStructure.png

2 开通云端录制服务

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

  • 拥有一个已接入 ZEGO 实时音视频 SDK 的应用。
  • 开通第三方云存储服务,目前支持 Amazon S3、阿里云 OSS、腾讯云 COS、七牛云 Kodo、阿里云 Vod(支持 MP4、 FLV 格式)。

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

3 实现云端录制

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

3.1 开始录制

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

  • 每个录制任务有时长限制:24小时,超过24小时自动停止。
  • 如果视频流、音频流、白板的服务都停止了,录制任务也会自动停止。

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

3.3 查询录制状态

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

3.4 更新混流布局

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

3.5 更新白板

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

3.6 停止录制

调用 StopRecord 方法停止录制。

4 管理录制文件

4.1 上传录制文件

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

  • FileUrl:返回录制文件的上传地址。
  • Status:返回录制文件的上传状态。
  • VideoId:Vod 返回录制文件的 VideoId。

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

4.2 管理录制文件名

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

相关文档