You need to enable JavaScript to run this app.
导航
企业直播
  • 文档首页
    • /企业直播/API 参考/直播消息回调/切片录制视频生成回调
切片录制视频生成回调
最近更新时间：2025.08.01 16:30:19首次发布时间：2025.04.16 15:44:11
复制全文
我的收藏
有用
有用
无用
无用

作用

当成功调用 GenerateActivityStreamSlice 接口生成直播流切片或通过直播伴侣生成录制切片时，企业直播会向您设置的回调地址发送回调消息。

前提条件

已调用 GenerateActivityStreamSlice 接口生成直播流切片，或在直播伴侣中完成以下操作生成录制切片。

  1. 在直播期间，打开录制开关。
    Image
  2. 在弹窗中，打开同步录至云端开关，并单击确认。在结束直播或录制时，即可生成该段时间的录制切片。
    Image

配置方式

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

详情

完成回调配置后，当成功调用 GenerateActivityStreamSlice 接口生成直播流切片或通过直播伴侣生成录制切片时，企业直播会将直播间 ID、切片录制视频的 Vid 等信息以 GET 方式提交给您设置的回调地址。
请求示例如下所示：

http://abc.com/test.do?ActivityID=123&SubAccountName=admin%40bytedance.com&EventType=ActivityStreamSliceGeneratedCallBack&AccountID=1&Vid=qq1&Timestamp=1751698800&Sign=xxxx&RequestUuid=ActivityStreamSliceGeneratedCallBack-182575****195867&LiveStartTime=1751520600&LiveEndTime=1751526000

超时重试

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

参数

参数

类型

说明

ActivityID

String

直播间 ID。

SubAccountName

String

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

AccountID

String

账号 ID。

EventType

String

回调通知的事件类型，固定取值为 ActivityStreamSliceGeneratedCallBack。

Vid

String

切片录制视频的 Vid。

Timestamp

String

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

LiveStartTime

String

切片录制视频对应的直播开始时间。Unix 时间戳，单位为秒。
例如直播于 2025-07-03 13:30:00 开始，2025-07-03 15:00:00 结束，则该参数取值为 1751520600。

LiveEndTime

String

切片录制视频对应的直播结束时间。Unix 时间戳，单位为秒。
例如直播于 2025-07-03 13:30:00 开始，2025-07-03 15:00:00 结束，则该参数取值为 1751526000。

Sign

String

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

  1. 按照 AccountSecret、AccountID、ActivityID、Timestamp、Vid 的顺序，拼接对应的参数值。
  2. 将拼接后的内容进行 MD5 加密生成 32 位小写字符串。

说明

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

RequestUuid

String

请求回调的唯一标识。