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 位小写字符串。

Status

String

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

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

SubAccountName

String

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

Timestamp

String

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

最近更新时间:2026.07.29 16:19:32
这个页面对您有帮助吗?
有用
有用
无用
无用