You need to enable JavaScript to run this app.
导航
合并回放视频结果回调
最近更新时间:2025.03.21 10:45:22首次发布时间:2023.07.10 10:47:58
我的收藏
有用
有用
无用
无用

作用

在调用 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 次。

参数

说明

请联系技术支持获取鉴权 AccountSecret

参数

类型

说明

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

Code

String

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

  • 0:成功
  • -1:失败

ErrorMsg

String

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

说明

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