云直播高光切片事件通知

一、注意事项

阅读这篇之前，希望你已经了解腾讯云直播是如何配置回调功能、你是如何接收回调消息的，具体请参见如何接收事件通知。

二、事件类型参数

事件类型	字段取值说明
高光切片	event_type = 349

三、回调公共参数

字段名称	类型	说明
t	int64	过期时间，事件通知签名的过期 UNIX 时间戳。来自腾讯云的消息通知默认过期时间是10分钟，如果一条消息通知中的 t 值所指定的时间已经过期，则可以判定这条通知无效，进而可以防止网络重放攻击。t 的格式为十进制 UNIX 时间戳，即从1970年01月01日（UTC/GMT 的午夜）开始所经过的秒数。
sign	string	事件通知安全签名 sign = MD5（key + t）。说明：腾讯云把加密 key 和 t 进行字符串拼接后通过 MD5 计算得出 sign 值，并将其放在通知消息里，你的后台服务器在收到通知消息后可以根据同样的算法确认 sign 是否正确，进而确认消息是否确实来自腾讯云后台。

注意：说明：

注意：key 为功能配置 >直播回调中的回调密钥，主要用于鉴权。为了保护你的数据信息安全，建议你填写。

注意：

四、高光切片回调消息参数

参数	类型	含义
appid	int	用户 APPID。
domain	string	推流域名。
path	string	推流 path 路径。
stream_id	string	流 ID。
items	Array of 高光切片信息	高光切片信息。

五、高光切片信息

参数	类型	含义
begin_time	int64	高光切片开始时间，UNIX 时间戳（秒）。
end_time	int64	高光切片结束时间，UNIX 时间戳（秒）。
title	string	标题。
summary	string	摘要。
video_store_url	string	高光切片视频 URL。
cov_img_store_url	string	高光切片视频封面 URL。
key_words	Array of string	关键词。

六、回调消息示例

{ "event_type": 349, "appid": 1234, "domain": "your.livepush.myqcloud.com", "path": "highlight", "stream_id": "test1820", "items": [ { "begin_time": 1761128808, "end_time": 1761128834, "title": "床单秒杀直降25元", "summary": "主播现场砍价，原价60元/米的XX省老粗布床单直接砍到25元，2×2.5米包边款，一号链接限时上车，手慢无。", "video_store_url": "http://your.cos.ap-nanjing.myqcloud.com/SmartHighlights/your.livepush.myqcloud.com/highlight/test1820/LIVE_0269433B4282FE8263010F7AF99BA792BC-1761128792340/2025-10-22_18-32-16_16666.mp4", "cov_img_store_url": "", "key_words": [ "25元", "一号链接", "XX省老粗布", "床单秒杀", "限时" ] } ]}

云直播 高光切片事件通知