云端录制

集成

更新时间:2021-09-10 14:48

1 接入流程

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

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

2 开通云端录制服务

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

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

完成以上准备工作后,请联系 ZEGO 技术支持开通云端录制服务。

3 实现云端录制

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

3.1 开始录制

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

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

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 参数。

相关文档