拉流转推事件通知

最近更新时间:2024-04-15 21:58:51

我的收藏
拉流转推回调主要用于回调拉流转推任务的状态信息,您需要在拉流转推任务中配置回调地址(回调地址具体配置见 拉流转推),腾讯云直播后台会将类型结果回调到您设置的接收服务器中。
本文主要讲解触发推断流回调事件后,腾讯云直播发送给用户的回调消息通知字段。

注意事项

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
Int
点播文件所在列表索引
duration
int
点播文件时长,秒
task_exit_time
int
任务退出时间,毫秒时间戳
code
Int
任务退出错误码
message
string
任务退出错误信息
type
string
告警回调(callback_event:TaskAlarm)使用, 告警类型有:
PullFileUnstable:文件拉取不稳定
PushStreamUnstable:推流不稳定
PullFileFailed:文件拉取出错
PushStreamFailed:推流出现失败
FileEndEarly:文件提前结束

回调消息示例

TaskStart - 任务开始回调
VodSourceFileStart - 点播文件开始时回调
VodSourceFileFinish - 点播文件结束时回调
TaskExit - 任务退出回调
TaskAlarm - 任务告警回调
{
"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://5000.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://5000.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://5000.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"
}

{
"appid": 4,
"callback_event": "TaskAlarm",
"event_type": 314,
"interface": "general_callback",
"msg": "{\\"url\\": \\"http://5000.livepush.myqcloud.com/live/normal_2307534720200521162358-upload-45eb/playlist.m3u8\\",\\"message\\":\\"Pull file unstable.\\",\\"type\\":\\"PullFileUnstable\\",\\"offset\\":123,"Duation":3333}",
"product_name": "pullpush",
"task_id": "118148",
"source_urls": "[\\"http://5000.livepush.myqcloud.com/live/normal_2307534720200521162358-upload-45eb/playlist.m3u8\\"]\\n",
"stream_id": "",
"to_url": "rtmp://5000.livepush.myqcloud.com/live/testdouyu"

}
注意
配置点播视频拉流转推的回调先后顺序为:TaskStart-任务开始回调 > VodSourceFileStart-点播文件开始时回调 > VodSourceFileFinish-点播文件结束回调
TaskStart-任务开始回调VodSourceFileStart-点播文件开始时回调 两个回调中间会有2s内的间隔。
拉流转推回调的配置是在拉流转推任务里配置的,具体操作请参见 拉流转推