logo
实时语音
服务端 API
当前页

点播截图回调


描述

开发者通过 开始点播截图 接口完成媒体文件转码后,可以通过该回调查询截图信息。

回调说明

  • 请求方法:POST。
说明

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

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

回调参数

公共参数类型描述
eventString回调事件。
此回调返回值为snapshot - 截图完成。
appidStringApp 的唯一标识。
timestampString服务器当前时间,Unix 时间戳。
nonceString随机数。
signatureString检验串,详情见 检验说明
业务参数类型描述
task_idString截图任务 ID,与 开始点播截图 响应结果中的 task_id 保持一致。
vendorStringCDN 厂商:
  • tencent:腾讯云。
  • hw:华为云。
field_idString源媒体文件 ID。
仅当 CND 厂商为腾讯云有该字段。
snapshot_pic_listArray SnapshotPicObject点播截图信息列表 JSON 数组格式字符串。
└ urlstring点播截图 URL
└ offsetfloat该张截图对应视频文件中的时间偏移,即为第多少毫秒的截图,单位为毫秒。
仅当 CND 厂商为腾讯云时,在时间点截图条件下,才有该字段。

数据示例

{
        "appid": "12345",  
        "event": "snapshot",
        "timestamp": "148150008",
        "nonce": "158243",
        "signature": "signature"
        "task_id": "1253642700910365374",
        "field_id": "abcwurywbhsfwi",
        "vendor": "tencent",
        "snapshot_pic_list": "[{\"url\":\"http://abc.com/1.jpg\",\"offset\":0},{\"url\":\"http://abc.com/1.jpg\",\"offset\":0}]",
}

返回响应

返回 HTTP status code 为 2XX (例如 200)表示成功,其他响应都表示失败。

回调重试策略

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

Previous

点播转码完成回调

Next

音频流审核回调