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

回调方式
当回调事件发生时,平台会以 HTTP POST 方式,通过 JSON 格式的数据向开发者指定的回调 URL 发送通知。回调失败时,平台会按照以下策略进行重试:
- 重试间隔:10秒
- 最大重试次数:2次
- 重试失败处理:若两次重试均失败,则丢弃此次回调。
当开发者的回调服务成功接收到通知并返回 HTTP 状态码 200 时,表示回调成功。若返回其他状态码,则视为回调失败。
回调安全校验
为了验证回调请求是否来自会议平台,平台会在回调请求的消息体(body)中包含一个签名参数 signature。开发者可以通过校验该签名的有效性来确认回调的来源。具体流程如下:
1.签名生成
签名生成规则如下,具体请参见鉴权方式的使用示例。
signature = sha256(secretId + '&' + time + '&' + secretKey)
2.参数说明
secretId:在会议管理后台获取secretKey:在会议管理后台获取time:在回调请求的消息体中返回
3.签名验证
开发者应将接收到的 Signature 与自己根据相同规则计算得出的 Signature 进行对比。如果两者一致,则表示回调请求来自会议平台。
回调事件
| EventType值 | 事件 |
|---|---|
| CREATE_MEETING | 创建会议 |
| JOIN_MEETING | 用户入会 |
| LEAVE_MEETING | 用户离会 |
| END_MEETING | 结束会议 |
| MEMBER_NICKNAME | 用户改名 |
| MEMBER_IDENTITY | 用户身份变化 |
| MEMBER_AUDIO | 用户麦克风变化 |
| MEMBER_CAMERA | 用户摄像头变化 |
| MEETING_LAYOUT | 视频布局变化 |
| MEETING_LOCK | 会议加锁/解锁 |
| MEETING_FOCUS_WINDOW | 主视频变更 |
| MEETING_CLOUDRECORD_STATE | 云端录制状态变化 |
| MEETING_LIVE_STATE | 直播状态变化 |
| CHANGE_OPTION 或 CHANGE_RIGHTS | 会议选项变化 |
| INVITE_CONTACT_STATE_CHANGE | 邀请成员变化 |