直播回放生成回调--企业直播-火山引擎

文档中心

立即注册

导航

企业直播

直播回放生成回调

最近更新时间：2025.08.01 16:30:19首次发布时间：2023.05.11 11:57:42

作用

当直播间生成直播回放时，即直播结束后自动生成回放或直播伴侣云端录制生成回放时，企业直播会向您设置的回调地址发送回调消息。

前提条件

直播已结束，或者在直播伴侣中完成以下操作并结束录制：

在直播期间，打开录制开关。
在弹窗中，打开同步录至云端开关，并单击确认。

配置方式

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

详情

完成回调配置后，当直播间生成直播回放时，即直播结束后自动生成回放或直播伴侣云端录制生成回放时，企业直播会将直播间 ID、回放视频等信息以 GET 方式提交给您设置的回调地址。
请求示例如下所示：

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

超时重试

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

参数

参数	类型	说明
ActivityID	String	直播间 ID。
SubAccountName	String	创建直播间的账号。参数值 `admin@bytedance.com` 表示直播间为主账号创建。
AccountID	String	账号 ID。
EventType	String	回调通知的事件类型，固定取值为 `ActivityAutoReplayCallBack`。
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	校验签名。完成以下步骤，计算校验签名。按照 `AccountSecret`、`AccountID`、`ActivityID`、`Timestamp`、`Vid` 的顺序，拼接对应的参数值。将拼接后的内容进行 MD5 加密生成 32 位小写字符串。说明 `AccountSecret` 的取值可通过控制台获取。详见步骤二：获取鉴权密钥。
RequestUuid	String	请求回调的唯一标识。