状态回调
云端录制在开始录制、文件切片、录制结束、上传的时候均提供 HTTP 录制状态回调,您可以拿到录制元信息和录制文件名、录制文件最终 URL 的对应关系。如果您已开通「云端录制」服务,并配置了公网可访问的回调 URL,融云会将录制的状态变化实时通知您在控制台配置的服务器地址。
请在控制台的云端录制页面,填写接收 HTTP 回调的 URL,配置后 15 分钟内生效。
回调方法
POST:<your-receiving-server-url>
数据格式:application/json
回调地址 <your-receiving-server-url>
是您在控制台为当前 App Key 和服务所配置的回调接收地址。请 务必配置可正常访问的回调接收地址。如果您的网络有 IP 访问限制,请务必配置 IP 白名单,否则无法正常接收服务端回调。
为了验证数据有效性并确保调用者为融云 Server,每个请求前添加数据签名。回调签名规则详见服务端回调。
状态回调公共字段
下表描述了云端录制服务不同状态的 HTTP 回调请求结果(JSON 对象)中的公共字段:
字段名称 | 类型 | 说明 |
---|---|---|
timestamp | Number | 时间戳,单位为毫秒。 |
type | Number | 回调事件类型,如下: 1: 录制开始; 2: 录制切片; 3: 录制结束; 4: 文件上传 |
appKey | String | 当前使用的 App Key。 |
recordId | String | 录制 ID,每次录制任务的唯一标识。如果文件切片,可以通过此 ID 进行关联。 |
roomId | String | 房间 ID 。 |
sessionId | String |