一、网络协议
如果在控制台配置了回调地址,即一个 HTTP(S) 协议接口的 URL,则需要支持 POST 方法,传输数据编码采用 UTF-8。
二、HTTP 头参数
| 名称 | 类型 | 是否必需 | 描述 |
| Signature | string | 是 | 签名,具体见下方 签名生成 说明 |
三、签名生成
Signature = HMAC-SH1 ( strContent, SecretKey )
·strContent:签名原文串,为 body 的整个 JSON 内容(长度以 Content-Length 为准)。
·body:回调给业务的 JSON 内容,下方 回调示例 中的全部内容即为 body。
·SecretKey:密钥,为应用的权限密钥,可通过 控制台 > 应用详情 查看。
·HMAC-SH1:签名算法。
四、回调参数
| 名称 | 类型 | 描述 |
| BizID | Integer | 应用的 AppID,可通过 控制台 > 应用详情 查看。 |
| RoomID | String | 房间 ID |
| UserID | String | 用户 ID |
| RecordMode | Integer | 录制模式0: 单流1: 混流 |
| Timestamp | Integer | 发送回调时的时间戳(s) |
| TaskID | Integer | 云录制服务分配的任务 ID。任务 ID 是对一次录制生命周期过程的唯一标识,结束录制时会失去意义。当你使用自定义录制模式时, 任务 ID 可以在开始录制时通过响应参数获取,需要业务保存下来,作为下次针对这个录制任务操作的请求参数。 |
| EventType | Integer | 事件类型 |
| Detail | EventDetail | 事件详情,由 EventType 决定格式 |
五、EventDetail 事件详情说明
| EventType | 说明 | Detail |
| 1 | 音频文件启动录制 | SeqNo: Number,分片序号FileName: String,文件名 |
| 2 | 音频文件完成录制 | SeqNo: Number,分片序号 FileName: String,文件名 |
| 3 | 音频文件上传完成 | SeqNo: Number,分片序号FileName: String,文件名 |
六、回调示例
{ "BizID":1400000000, "RoomID":"100", "UserID":"999", "TaskID":446946705284000000, "RecordMode":1, "Timestamp":1675930605, "EventType":1, "Detail":{ "SeqNo":0, "FileName":"1400000000_100_999/2023-02-09-16-16-45_446946705284000000_audio.mp3" }}