tencent cloud

高光切片事件通知
下载PDF
最后更新时间：2025-12-03 17:56:30
高光切片事件通知
最后更新时间： 2025-12-03 17:56:30
下载PDF
若您配置了直播高光切片回调地址，在切片生成后，后台会将生成的切片的信息以 JSON 形式回调至您的回调地址。您可以通过回调内容，进行后续的处理操作。
本文主要介绍触发高光切片回调事件后，腾讯云直播发送给用户的回调消息通知字段。

注意事项

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

高光切片事件参数说明

事件类型参数

事件类型
字段取值说明
高光切片
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省老粗布",
                "床单秒杀",
                "限时"    
            ]
        }
    ]
}

本页内容是否解决了您的问题？
您也可以 联系销售 或 提交工单 以寻求帮助。
是
否

文档反馈