云端录制提供RESTful API,业务可以通过发送请求来使用云录制的功能。
- 请求仅支持 HTTPS 协议;
- 提供回调功能,业务配置后就可以收到云录制的回调通知
在发送RESTful API请求时,需使用AppID和AppSecret计算出对应鉴权信息填入HTTPS请求头部,通过签名认证来识别合法请求。
在应用申请通过后,业务可在开发者平台获取AppID和AppSecret。具体签名认证方法请参考 签名认证。
updatemixrecord更新混画布局是可选的,且可以多次调用,但是必须在启动录制之后和停止录制之前调用。
调用 applyrecord
方法请求一个用于云录制的资源resid。
调用该方法成功后,你可以从 HTTP 响应包体中的 resid
字段得到这个ID。这个 resid 的时效为 5 分钟,你需要在 5 分钟内用这个ID开始录制。
一个 resid仅可用于一次录制。
该方法的请求和响应示例详见 applyrecord
示例。
获得 resid 后,在五分钟內调用 startrecord
方法加入频道启动录制。
调用该方法成功后,你可以从 HTTP 响应包体中获得一个 recordid, 该 recordid 是一次录制周期的唯一标识。
该方法的请求和响应示例详见 startrecord
示例。
在启动录制后,调用 stoprecord
方法停止录制。
当频道空闲(无用户发布流数据)超过预设时间(默认为 30 秒) 后,云录制也会自动停止录制。如需特殊配置请联系与您对接的技术支持人员。
该方法的请求和响应示例详见 stoprecord
示例。
在启动录制后,可以调用 updatemixrecord
方法来更新录制的混流参数。
该方法的请求和响应示例详见 updatemixrecord
示例)。
上述文件名中各字段含义如下:
recordid: 录制id
roomid: 房间号
uid: 用户id
rid, uid_s, uid_e: 为固定标识
后台服务器将直播媒体流进行TS切片,并不断上传到指定的oss存储路径。在完成录制文件后,会生成一个 M3U8 文件并上传。