tencent cloud

Live screencapture takes real-time screenshots from a live stream at the specified interval and stores them in COS. A screencapture callback returns information about stored screenshots, including the screenshot generation time, image size, file path, and download link. To receive screencapture callbacks, you need to configure your server address in a callback template and bind the template with your push domain. When a live screencapture event occurs, the CSS backend will send the screenshot information to the server configured.

This document describes the fields in a live screencapture callback message.

Notes

• This document assumes you already know how to configure and receive callbacks.
• The information returned by a screencapture callback can be used for porn detection, live video thumbnail generation, and other scenarios.

Screencapture Event Parameters

Event type

Common callback parameters

Note：

A key is used for authentication. You can set it in Event Center > Live Stream Callback. We recommend you set it to ensure data security.

Callback message parameters

Sample callback message

{
    "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
}