动态与公告

公告

新手指南

产品简介

产品概述

子产品简介

基本概念

产品功能

应用场景

产品优势

使用限制

购买指南

计费概述

基础服务费

增值服务费

预付费资源包

购买流程

计费变更

退款说明

账单查询

续费说明

欠费停服说明

计费常见问题

标准直播

概述

应用场景

快速入门

SDK 接入说明

快直播（超低延时直播）

概述

快直播和标准直播区别

应用场景

快速入门

SDK 接入说明

云导播台

概述

应用场景

功能区介绍

云导播台管理

通用云导播

配置节目单和自动导播

控制台指南

控制台介绍

概览

域名管理

流管理

资源包管理

AI 智能

功能配置

拉流转推

计费用量

业务监控

常用工具

无忧直播

CAM 访问控制

功能实践

直播推流与播放

直播增值功能

典型场景实践

云端原生录制

直播安全

海外直播

回调事件消息通知

常见第三方工具指南

SDK 实践

0. SDK 接入引导

1. 推流

2. 播放

3. 高级功能

API 文档

History

Introduction

API Category

Making API Requests

Live Pad APIs

Live Stream Mix APIs

Time Shifting APIs

Monitoring Data Query APIs

Billing Data Query APIs

Live Transcoding APIs

Delayed Playback Management APIs

Domain Name Management APIs

Watermark Management APIs

Certificate Management APIs

Stream Pulling APIs

Recording Management APIs

Live Callback APIs

Screencapturing and Porn Detection APIs

Authentication Management APIs

Live Stream Management APIs

Data Types

Error Codes

运维指南

优化视频卡顿

推流失败问题排查

播放失败问题排查

CLS 协助直播问题排查

直播延迟问题排查

拉流视频质量不清晰问题排查

COS bucket 授权给直播实现截图存储

故障处理

直播混流报错：InvalidParameter.OtherError

常见问题

服务地区相关

直播基础相关

推流播放相关

直播计费相关

直播海外相关

直播录制相关

云端混流相关

域名配置相关

云导播台相关

适配苹果 ATS 相关

服务等级协议

云直播服务等级协议

CSS 政策

隐私协议

数据处理和安全协议

词汇表

拉流转推事件通知

PDF

聚焦模式

字号

最后更新时间： 2025-09-10 14:23:27

拉流转推回调主要用于回调拉流转推任务的状态信息，您需要在拉流转推任务中配置回调地址，腾讯云直播后台会将类型结果回调到您设置的接收服务器中。
本文主要讲解触发推断流回调事件后，腾讯云直播发送给用户的回调消息通知字段。
注意事项
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。
﻿msg﻿
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
任务退出错误信息。
type
string
告警回调（callback_event:TaskAlarm）使用，告警类型有： 
PullFileUnstable：文件拉取不稳定。
PushStreamUnstable：推流不稳定。
PullFileFailed：文件拉取出错。
PushStreamFailed：推流出现失败。
FileEndEarly：文件提前结束。
回调消息示例
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内的间隔。
拉流转推回调的配置是在拉流转推任务里配置的，具体操作请参见 拉流转推。

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

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

tencent cloud

云直播

拉流转推事件通知

注意事项

拉流转推事件参数说明

事件类型参数

回调公共参数

msg 内参数说明

回调消息示例

帮助和支持