You need to enable JavaScript to run this app.
文档中心
企业直播

企业直播

复制全文
下载 pdf
直播消息回调
AI 直播复盘任务状态回调
复制全文
下载 pdf
AI 直播复盘任务状态回调

作用

当 AI 直播复盘任务状态变化时,企业直播会对所设置的接口地址进行回调通知。

配置方式

完成回调配置。详见回调配置

详情

完成回调配置后,当 AI 直播复盘任务状态变化时,企业直播系统会将直播间 ID、账号 ID、直播场次 ID 等信息以 POST 方式提交给您设置的回调地址。 请求示例如下所示:

POST /xxxxx HTTP/1.1
Header1: ...
Header2: ...
...
{
 "AccountId": "2000000872",
 "ActivityId": "186455*****2460906",
 "Code": "0",
 "ErrorMsg": "",
 "EventType": "LiveAnalysisStatusModifyCallback",
 "HistoryId": "203387",
 "RequestUuid": "LiveAnalysisStatusModifyCallback-1864795****51",
 "Sign": "d420764320e0b0c40d191******68",
 "Status": "2",
 "SubAccountName": "admin@bytedance.com",
 "Timestamp": "1778408829"
}

超时重试

回调服务器在发送消息通知后,5 秒内没有收到您的服务器的响应,即认为通知失败。后续会以 5 秒为间隔继续重试 2 次。

参数

参数

类型

说明

AccountId

String

账号 ID。

ActivityId

String

直播间 ID。

Code

String

用于判断直播复盘任务是否失败.取值情况如下:

  • 当任务失败时,返回 -1,同时 ErrorMsg 参数返回失败原因。
  • 其它情况返回 0

ErrorMsg

String

复盘任务失败的具体原因。取值如下:

  • video_duration_out_of_range:直播时长超出限制。支持时长范围:10 分钟至 4 小时
  • vod_frame_extraction_failed:审核抽帧失败
  • llm_task_failed:大模型任务失败
  • inspect_timeout:任务执行超时
  • manual_terminated: 用户手动关闭了本场次直播复盘

说明

仅当 Code 参数为 -1 时,返回该参数。

EventType

String

回调通知的事件类型,固定取值为 LiveAnalysisStatusModifyCallback

HistoryId

String

直播场次 ID。

RequestUuid

String

请求回调的唯一标识。

Sign

String

校验签名。
完成以下步骤,计算校验签名。

  1. 按照 ActivityIdHistoryIdEventTypeTimestamp 的顺序,拼接对应的参数值。
  2. 将拼接后的内容进行 MD5 加密生成 32 位小写字符串。

说明

AccountSecret 的取值可通过控制台获取。详见获取鉴权密钥

Status

String

AI 直播复盘任务的状态。取值如下:

  • 1:直播复盘任务已开始
  • 2:直播复盘任务已结束

SubAccountName

String

创建直播间的账号。参数值 admin@bytedance.com 表示直播间为主账号创建。

Timestamp

String

发送回调请求的时间。Unix 时间戳,单位为秒。

最近更新时间:2026.06.04 17:51:48
这个页面对您有帮助吗?
有用
有用
无用
无用