云直播 截图事件通知

一、注意事项

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

·截图回调事件触发后获取的截图信息可应用于直播画面审核、直播房间封面等多种场景。

二、事件类型参数

事件类型	字段取值说明
直播截图	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。
task_id	string	截图任务 ID。

五、回调消息示例

{ "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-1280×720.jpg", "pic_url":"/channelid/channelid-screenshot-10-12-05-1280×720.jpg", "sign":"ca3e25e5dc17a6f9909a9ae7281e300d", "stream_id":"your_streamid", "stream_param":"txSecret=ca3e25e5dc17a6f9909a9ae7281e300d&txTime=60B83800", "t":1622600525, "width":1280, "task_id":"1867908378267662126"}