截图事件通知

Recent Pages

截图事件通知

最后更新时间：2023-10-08 14:33:24

直播截图是以固定的时间间隔截取实时直播流的图像，并生成图片存储到 COS 中。而截图回调则是用于推送截图存储图片文件信息，主要包括图片生成时间、图片大小、所在路径以及可下载地址。您需在回调模板中配置截图回调消息接收服务器地址，并将该模板与推流域名进行关联。当直播流触发截图事件后，腾讯云直播后台会将截图信息回调到您设置的接收服务器中。
本文主要讲解触发截图回调事件后，腾讯云直播发送给用户的回调消息通知字段。
注意事项
阅读本文之前，希望您已经了解腾讯云直播是如何配置回调功能、您是如何接收回调消息的，具体请参见 如何接收事件通知。
截图回调事件触发后获取的截图信息可应用于直播鉴黄、直播房间封面等多种场景。
截图事件参数说明
事件类型参数
事件类型
字段取值说明
直播截图
event_type = 200
回调公共参数
字段名称
类型
说明
t
int64
过期时间，事件通知签名过期 UNIX 时间戳。
来自腾讯云的消息通知默认过期时间是10分钟，如果一条消息通知中的 t 值所指定的时间已经过期，则可以判定这条通知无效，进而可以防止网络重放攻击。
t 的格式为十进制 UNIX 时间戳，即从1970年01月01日（UTC/GMT 的午夜）开始所经过的秒数。
sign
string
事件通知安全签名 sign = MD5（key + t）。说明：腾讯云把加密 key 和 t 进行字符串拼接后通过 MD5 计算得出 sign 值，并将其放在通知消息里，您的后台服务器在收到通知消息后可以根据同样的算法确认 sign 是否正确，进而确认消息是否确实来自腾讯云后台。
﻿
说明
 key 为 功能配置 > 直播回调 中的回调密钥，主要用于鉴权。为了保护您的数据信息安全，建议您填写。
﻿
﻿
﻿
回调消息参数
字段名称
类型
说明
app
string
推流域名
appname
string
推流路径
stream_param
string
用户推流 URL 所带参数
stream_id
string
直播流名称
channel_id
string
同直播流名称
create_time
int64
截图生成 UNIX 时间戳
file_size
int
截图文件大小，单位为字节
width
int
截图宽，单位为像素
height
int
截图高，单位为像素
pic_url
string
截图文件路径 /path/name.jpg
pic_full_url
string
截图下载 URL
回调消息示例
{
    "app":"test.app",
﻿
    "appname":"live",
﻿
    "channel_id":"your_channelid",
﻿
    "create_time":1622599925,
﻿
    "event_type":200,
﻿
    "file_size":30670,
﻿
    "height":720,
﻿
    "pic_full_url":"http://your.cos.region.myqcloud.com/channelid/channelid-screenshot-10-12-05-1280x720.jpg",
﻿
    "pic_url":"/channelid/channelid-screenshot-10-12-05-1280x720.jpg",
﻿
    "sign":"ca3e25e5dc17a6f9909a9ae7281e300d",
﻿
    "stream_id":"your_streamid",
﻿
    "stream_param":"txSecret=ca3e25e5dc17a6f9909a9ae7281e300d&txTime=60B83800",
﻿
    "t":1622600525,
﻿
    "width":1280
}
﻿
﻿

联系我们

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

技术支持

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

7x24 电话支持

tencent cloud

Recent Pages

截图事件通知

注意事项

截图事件参数说明

事件类型参数

回调公共参数

回调消息参数

回调消息示例

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

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

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

tencent cloud

注册

登录

Recent Pages

截图事件通知

注意事项

截图事件参数说明

事件类型参数

回调公共参数

回调消息参数

回调消息示例

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

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