媒体文件合并完成回调

更新时间：2025-04-15 17:17

1 描述

调用合并媒体文件前配置了回调地址且 CDN 厂商为腾讯云或华为云时，合并任务完成时会收到该回调，回调将以 POST 的形式对回调地址进行请求。

收到媒体文件合并完成回调后，建议 5s 后再检索相关信息。

2 回调说明

请求方法：POST。

回调数据格式为 JSON，您需要对其进行 UrlDecode 解码。

请求地址：请联系 ZEGO 技术支持配置回调地址。
传输协议：HTTPS/HTTP，建议使用 HTTPS。

3 回调参数

参数	类型	描述
appid	String	AppId。
event	String	回调事件，此回调返回值为 compose。
replay_url	String	合并后的媒体文件的回看地址，不超过 1024 字节。
task_id	String	任务 ID，与合并媒体文件接口响应中 Data 参数内携带的 TaskId 相同。
file_id	String	文件 ID，与检索媒体信息接口响应中 Data 参数内携带的 FileId 相同。仅在 CDN 厂商为腾讯云时返回。
code	String	错误码。0 表示成功，其他值表示失败： 40000：输入参数不合法，请检查输入参数 60000：源文件错误（如视频数据损坏），请确认源文件是否正常 70000：内部服务错误，建议重试仅在 CDN 厂商为腾讯云时需关注。
message	String	错误信息。仅在 CDN 厂商为腾讯云时需关注。
timestamp	String	服务器当前时间，Unix 时间戳。
nonce	String	随机数。
signature	String	检验串，请参考回调说明 - 检验说明。

4 数据示例

{
    "appid": "1",
    "event": "compose",
    "replay_url": "replay_url",
    "task_id": "task_id",
    "file_id": "5285890813218549789",
    "code": "0",
    "message": "message",
    "timestamp": "1481597358",
    "nonce": "158273",
    "signature": "signature"
}

5 返回响应

返回 HTTP status code 为 2XX （例如 200）表示成功，其他响应都表示失败。

6 回调重试策略

如果 ZEGO 服务器没有收到响应，或收到的 HTTP status code 不为 2XX（例如 200），都会尝试重试，最多进行 5 次重试。每次重试请求与上一次请求的间隔时间分别为 2s、4s、8s、16s、32s。若第 5 次重试后仍然失败，将不再重试，该回调丢失。