回调配置说明

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

image-20240823103509330

回调方式

当回调事件发生时,平台会以 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 邀请成员变化