录制开始/结束事件回调通知

更新时间：2026-07-06 14:19:25

作用

使用本功能，研讨会开始录制或结束录制后，服务端会对客户所设置的接口地址，以 POST JSON 方式提交到用户自定义的回调接口进行通知。

详情

接口地址配置完成后，当研讨会发生以下录制事件时会触发回调：

开始录制：seminar_record_start
结束录制：seminar_record_stop

回调请求会以 JSON Body 传递业务参数，同时在回调 URL 上追加 timestamp 和 sign 参数，例如：

POST http://abc.com/test.do?timestamp=1720000000000&sign=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

{
  "eventId": "f0f6d3f6f4f14b1bb58b69c4e2a2e9d3",
  "eventType": "seminar_record_start",
  "eventTime": "1720000000123",
  "triggerType": "manual",
  "channelId": "12345678",
  "channelName": "研讨会演示频道",
  "seminarId": "seminar-demo-001"
}

回调参数说明

URL Query 参数

参数名	类型	说明
timestamp	Long	13 位时间戳
sign	String	校验的加密字符串，生成规则为 `md5(AppSecret+timestamp)`，`AppSecret` 为直播系统应用密钥

JSON Body 参数

参数名	类型	说明
eventId	String	事件唯一标识，客户系统可据此去重
eventType	String	事件类型 `seminar_record_start`：开始录制 `seminar_record_stop`：结束录制
eventTime	String	服务端记录的事件发生时间，13 位时间戳
triggerType	String	触发方式 `manual`：手动录制 `auto`：自动录制
channelId	String	直播频道号或直播间 ID
channelName	String	直播频道名称
seminarId	String	研讨会独立标识，仅当当前研讨会存在独立标识时返回

说明

接口如果没有返回 HTTP Status 200 状态码，会认为本次回调失败，针对失败情况会重试 3 次
回调重试间隔依次为 5 秒、10 秒、15 秒
eventId 每次事件触发时都会生成新的唯一值，建议业务方做幂等处理

如何设置

通过后台设置：

登录账户 - 进入【云直播】 - 点击【开发设置】 - 点击【回调设置】 - 研讨会事件回调 URL

注意：提交的接口地址必须要以 http:// 或者 https:// 开头

研讨会服务端 API

录制开始/结束事件回调通知

回调参数说明

URL Query 参数

JSON Body 参数

如何设置