游戏多媒体引擎 回调说明

受网络影响,你的服务器收到的通知顺序和事件发生的顺序可能不完全一致。
我们的服务有重试机制,但仍不能保证所有的消息都能到达。
考虑到以上两点,不建议你业务的核心业务逻辑依赖消息通知服务。

相关产品
游戏多媒体引擎 产品页,含版本规格、价格与购买入口。

一、网络协议

如果在控制台配置了回调地址,即一个 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" }}

赞 (0)
上一篇 4天前
下一篇 4天前