音视频通话

回调配置说明

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

image-20240807153408880

回调方式

当回调事件发生时,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 录制事件通知