截图事件通知

最后更新时间:2021-07-13 10:18:03

    直播截图是以固定的时间间隔截取实时直播流的图像,并生成图片存储到 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
    }