回调配置说明
登录 SDK 管理后台,在【回调设置】中配置回调服务地址及相关回调事件。

回调方式
当回调事件发生时,SDK平台会通过 HTTP POST 方式,通过 JSON 格式的数据向开发者指定的回调 URL 发送通知。若回调失败,平台会按照以下规则进行重试:
- 重试间隔:10秒
- 最大重试次数:2次
- 重试失败处理:若两次重试均失败,则丢弃此次回调。
如果开发者的回调服务返回 HTTP 200 状态码,则表示回调成功;如果返回其他状态码,则视为回调失败。
回调安全校验
为了验证回调请求是否来自SDK平台,平台会在回调请求的消息体(body)中包含一个签名参数 signature。开发者可以通过校验该签名的有效性来确认回调的来源。具体流程如下:
1.签名生成
签名通过 MD5 加密算法生成,结果为32位小写字符串。签名计算方式如下:
Signature = md5(CompID + '&' + CompSecret + '&' + Time)
2.参数说明
-
CompID:在SDK管理后台可查看
-
CompSecret:在SDK管理后台可查看
-
Time:在回调请求的消息体中返回
3.签名验证
开发者应将接收到的 Signature 与自己根据相同规则计算得出的 Signature 进行对比。如果两者一致,则表示回调请求来自SDK平台。
回调事件
| EventType | 事件 |
|---|---|
| ROOM_CREATE | 创建房间 |
| ROOM_END | 结束房间 |
| ROOM_DELETE | 销毁房间 |
| ROOM_JOIN | 加入房间 |
| ROOM_LEAVE | 离开房间 |
| RECORD_FINISH | 录制完成 |
| SIP_REG_STATE_CHANGED | 设备注册状态 |
| MEMBER_CAMERA_LIST_CHANGED | 成员摄像头列表变化 |
| MEMBER_CAMERA_STATUS_CHANGE | 成员摄像头开关状态变化 |
| RECORD_STATE | 录制状态通知 |
| RECORD_FILE_STATE | 录制事件通知 |