tencent cloud

文档反馈

拉流转推事件通知

最后更新时间:2024-04-25 10:48:26
    拉流转推回调主要用于回调拉流转推任务的状态信息,您需要在拉流转推任务中配置回调地址,腾讯云直播后台会将类型结果回调到您设置的接收服务器中。
    本文主要讲解触发推断流回调事件后,腾讯云直播发送给用户的回调消息通知字段。

    注意事项

    1. 阅读本文之前,希望您已经了解腾讯云直播是如何配置回调功能、您是如何接收回调消息的,具体请参见 如何接收事件通知
    2. 任务未到结束时间前,因源或者目标地址不可用进行持续重试,或者机器异常进行任务自动迁移,均会产生任务结束回调,不可将该回调作为任务最终结束回调使用。
    3. 如需要判断任务是否正常推流中,可从接收流地方进行判断,如云直播的断流回调,或流状态查询接口等方式。

    拉流转推事件参数说明

    事件类型参数

    事件类型
    字段取值说明
    拉流转推
    event_type = 314

    回调公共参数

    参数
    类型
    含义
    appid
    int
    用户 APPID
    callback_event
    string
    回调事件类型
    source_urls
    string
    拉流源 URL
    to_url
    string
    推流目标 URL
    stream_id
    string
    直播流名称
    task_id
    string
    任务 ID
    string
    不同事件,详细回调信息
    event_time
    string
    事件发生时间戳,示例:"1712893433"
    

    msg 内参数说明

    参数
    类型
    含义
    task_start_time
    int
    任务开始时间,毫秒时间戳
    url
    string
    当前正拉取的源 URL
    index
    string
    点播文件所在列表索引
    duration
    int
    点播文件时长,秒
    task_exit_time
    int
    任务退出时间,毫秒时间戳
    code
    string
    任务退出错误码
    message
    string
    任务退出错误信息

    回调消息示例

    TaskStart - 任务开始回调
    VodSourceFileStart - 点播文件开始时回调
    VodSourceFileFinish - 点播文件结束时回调
    TaskExit - 任务退出回调
    
    {
    "appid": 4,
    
    "callback_event": "TaskStart",
    
    "event_type": 314,
    
    "interface": "general_callback",
    
    "msg": "{\\"task_start_time\\":0}",
    
    "product_name": "pullpush",
    
    "source_urls": "[\\"http://yourURL.cn/live/normal_230753472*****21162358-upload-45eb/playlist.m3u8\\"]\\n",
    
    "stream_id": "testvod",
    
    "task_id": "118148",
    
    "to_url": "rtmp://xxx.livepush.myqcloud.com/live/testvod"
    }
    
    
    {
    "appid": 4,
    
    "callback_event": "VodSourceFileStart",
    
    "callback_url": "http://you.callback.url",
    
    "event_type": 314,
    
    "interface": "general_callback",
    
    "msg": "{\\"url\\":\\"http://remit-tx-ugcpub.douyucdn2.cn/live/normal_466247620*****3100448-upload-216b/playlist.m3u8\\",\\"index\\":0,\\"duration\\":14920}",
    
    "product_name": "pullpush",
    
    "source_urls": "[\\"http://yourURL.cn/live/normal_466247620*****3100448-upload-216b/playlist.m3u8\\"]\\n",
    
    "stream_id": "testvod",
    
    "task_id": "118145",
    
    "to_url": "rtmp://xxx.livepush.myqcloud.com/live/testvod"
    }
    
    {
    "appid": 4,
    
    "callback_event": "VodSourceFileFinish",
    
    "callback_url": "http://you.callback.url",
    
    "event_type": 314,
    
    "interface": "general_callback",
    
    "msg": "{\\"url\\":\\"http://yourURL.cn/live/normal_466247620*****3100448-upload-216b/playlist.m3u8\\",\\"index\\":0,\\"duration\\":14920}",
    
    "product_name": "pullpush",
    
    "source_urls": "[\\"http://yourURL.cn/live/normal_466247620*****3100448-upload-216b/playlist.m3u8\\"]\\n",
    
    "stream_id": "testvod",
    
    "task_id": "118145",
    
    "to_url": "rtmp://xxx.livepush.myqcloud.com/live/testvod"
    }
    
    {
    "appid": 4,
    
    "callback_event": "TaskExit",
    
    "event_type": 314,
    
    "interface": "general_callback",
    
    "msg": "{\\"message\\":\\"write packet error.\\",\\"code\\":-22,\\"task_exit_time\\":0}",
    
    "product_name": "pullpush",
    
    "source_urls": "[\\"http://yourURL.cn/live/normal_230753472*****21162358-upload-4\\"]\\n"
    }
    
    注意
    配置点播视频拉流转推的回调先后顺序为:TaskStart-任务开始回调 > VodSourceFileStart-点播文件开始时回调 > VodSourceFileFinish-点播文件结束回调
    TaskStart-任务开始回调VodSourceFileStart-点播文件开始时回调 两个回调中间会有2s内的间隔。
    拉流转推回调的配置是在拉流转推任务里配置的,具体操作请参见 拉流转推
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持