- 产品动态
- 产品介绍
- 新手指引
- 购买指南
- SDK 下载指引
- 产品功能体验
- 控制台指南
- 快速入门
- 基础功能开发指南
- 进阶功能开发指南
- 客户端 API
- 服务端 API
- 常见问题
- 服务协议
- 联系我们
- 词汇表
- GME 政策
- 产品动态
- 产品介绍
- 新手指引
- 购买指南
- SDK 下载指引
- 产品功能体验
- 控制台指南
- 快速入门
- 基础功能开发指南
- 进阶功能开发指南
- 客户端 API
- 服务端 API
- 常见问题
- 服务协议
- 联系我们
- 词汇表
- GME 政策
服务端录制回调说明
说明
受网络影响，您的服务器收到的通知顺序和事件发生的顺序可能不完全一致。我们的服务有重试机制，但仍不能保证所有的消息都能到达。考虑到以上两点，不建议您业务的核心业务逻辑依赖消息通知服务。
网络协议
如果在控制台配置了回调地址，即一个 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 | |
RoomID | String | 房间 ID |
UserID | String | 用户 ID |
RecordMode | Integer | 录制模式 0：单流 1：混流 |
Timestamp | Integer | 发送回调时的时间戳（s） |
TaskID | Integer | 云录制服务分配的任务 ID。任务 ID 是对一次录制生命周期过程的唯一标识，结束录制时会失去意义。当您使用自定义录制模式时，任务 ID 可以在开始录制时通过响应参数获取，需要业务保存下来，作为下次针对这个录制任务操作的请求参数。 |
EventType | Integer | 事件类型 |
Detail | 事件详情，由 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"}}
是
否
本页内容是否解决了您的问题？