You need to enable JavaScript to run this app.
企业直播

企业直播

复制全文
直播消息回调
合并回放视频结果回调
复制全文
合并回放视频结果回调

作用

在调用 MediasMergeAPI 接口完成回放视频合并任务时,企业直播会向您设置的回调地址发送回调消息。

配置方式

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

详情

完成回调配置后,在调用 MediasMergeAPI 接口完成回放视频合并任务时,企业直播会将直播间 ID 以及合并生成的回放视频信息以 GET 方式提交给您设置的回调地址。
请求示例如下所示:

http://abc.com/test.do?AccountId=2000000****&ActivityId=182565784636****&Code=0&ErrorMsg=&EventType=MediaMergeResultCallBack&MediaName=文件&MergeTaskId=d070c8da0563438e90ceae69fa******&OnlineStatus=0&RequestUuid=MediaMergeResultCallBack-18245595140****&Sign=23a3d59b66c79c89684f6422938****&SubAccountName=admin%40byteance.com&Timestamp=1741180474&Vid=v0c251g7007acv44sdvog65gj******&VideoSubAccountName=%2B8618037381955

超时重试

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

参数

参数

类型

说明

ActivityId

String

直播间 ID,合并生成的视频文件上架至该直播间。

说明

仅在调用 MediasMergeAPI 接口传入 ActivityId 时,该参数有值。

SubAccountName

String

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

说明

仅当 ActivityId 有值时,该参数有值。

AccountId

String

账号 ID。

RequestUuid

String

请求回调的唯一标识。

MergeTaskId

String

合并任务 ID。

EventType

String

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

Vid

String

合并生成的视频文件的 Vid。

VideoSubAccountName

String

创建视频的账号。参数值 admin@bytedance.com 表示视频为主账号创建。

MediaName

String

合并生成的视频文件的名称。名称默认为:合并文件 + "_" + 年月日 + 时分。例如 合并文件_202306301230

OnlineStatus

String

合并生成的视频文件的上架状态。取值如下:

  • 0:不上架
  • 1:上架

Timestamp

String

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

Sign

String

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

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

说明

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

Code

String

合并任务是否执行成功。取值如下:

  • 0:成功
  • -1:失败

ErrorMsg

String

合并任务失败的报错信息。

说明

仅当 Code 取值为 -1 时,该参数有值。

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