tencent cloud

截图是截取视频特定位置的图像并生成图片的过程，是一种离线任务。云点播提供以下类型的截图：

• 指定时间点截图：指定一组时间点，截取视频在这些时间点的图像。
• 采样截图：按相同的时间间隔对视频截取多张图。
• 截取一张图作封面：指定一个时间点截图，将其 URL 作为媒资系统中该视频的封面。
• 截雪碧图：按相同的时间间隔对视频截取多张小图，然后组装成若干大图（即雪碧图）。

使用截图功能，可以满足如下应用场景：

• 为视频生成封面：使用视频的截图作为视频的封面。
• 缩略图：雪碧图是嵌套了多个小图（即缩略图）的大图，常用来表示一个视频的概要。
• 播放预览：雪碧图配合 VTT 文件，可以用来实现播放器进度条上的预览效果。

截图模板

截图的目标规格，包含截图文件格式、截图宽高等参数。云点播使用截图模板表示截图参数集合，通过截图模板，可以指定以下截图相关参数。

时间点截图模板

时间点截图模板，用于“指定时间点截图”和“截取一张图作封面”两种任务。

针对常见的规格，云点播提供 预置时间点截图模板。另外，您还可以通过控制台创建和管理自定义截图模板，具体操作请参见 模板设置。

采样截图模板

采样截图模板，用于“采样截图”任务。

针对常见的规格，云点播提供了 预置采样截图模板。另外，您还可以通过控制台创建和管理自定义截图模板，具体操作请参见 模板设置。

雪碧图模板

雪碧图模板，用于“截雪碧图”任务。

注意：

• Width × Columns 需要在128px - 4096px之间（即大图宽度在128px - 4096px之间）。
• Height × Rows 需要在128px - 4096px之间（即大图高度在128px - 4096px之间）。

针对常见的规格，云点播提供了 预置雪碧图模板。另外，您还可以通过控制台创建和管理自定义截图模板，具体操作请参见 模板设置。

任务发起

发起截图任务，有“通过服务端 API 直接发起”，“通过控制台直接发起”和“上传时指定要执行的任务”三种方式。具体请参照视频处理的 任务发起。

以下是各种方式发起截图任务的说明：

• 调用服务端 API ProcessMedia 发起任务：在请求中的MediaProcessTask.SnapshotByTimeOffsetTaskSet参数指定 截图模板 的模板 ID。
• 通过控制台对视频发起任务：在控制台 添加任务流，任务流中设置目标截图规格；在控制台使用该任务流 发起视频处理。
• 服务端上传时指定任务：在控制台 添加任务流，任务流中设置目标截图规格 申请上传 中的procedure参数指定为该任务流。
• 客户端上传时指定任务：在控制台 添加任务流，任务流中设置目标截图规格；在 客户端上传签名 中的procedure指定该任务流。
• 控制台上传：在控制台 添加任务流，任务流中设置目标截图规格；通过控制台上传视频，选择 上传的同时对视频进行处理操作 并指定视频上传后执行该任务流。

结果获取

发起截图任务后，您可以通过异步等待 结果通知 和同步进行 任务查询 两种方式获取截图任务的执行结果。下面是发起截图任务后，普通回调方式下结果通知的示例（省略了值为 null 的字段）：

{
    "EventType":"ProcedureStateChanged",
    "ProcedureStateChangeEvent":{
        "TaskId":"1256768367-Procedure-2e1af2456351812be963e309cc133403t0",
        "Status":"FINISH",
        "FileId":"5285890784246869930",
        "FileName":"动物世界",
        "FileUrl":"http://1256768367.vod2.myqcloud.com/xxx/xxx/AtUCmy6gmIYA.mp4",
        "MetaData":{
            "AudioDuration":60,
            "AudioStreamSet":[
                {
                    "Bitrate":383854,
                    "Codec":"aac",
                    "SamplingRate":48000
                }
            ],
            "Bitrate":1021028,
            "Container":"mov,mp4,m4a,3gp,3g2,mj2",
            "Duration":60,
            "Height":480,
            "Rotate":0,
            "Size":7700180,
            "VideoDuration":60,
            "VideoStreamSet":[
                {
                    "Bitrate":637174,
                    "Codec":"h264",
                    "Fps":23,
                    "Height":480,
                    "Width":640
                }
            ],
            "Width":640
        },
        "MediaProcessResultSet":[
            {
                "Type":"SnapshotByTimeOffset",
                "SnapshotByTimeOffsetTask":{
                    "Status":"SUCCESS",
                    "ErrCode":0,
                    "Message":"",
                    "Input":{
                        "Definition":10,
                        "Definition":[3, 6, 9]
                    },
                    "Output":{
                        "Definition":10,
                        "PicInfoSet": [
                            {
                                "TimeOffset":3,
                                "Url":"http://1256768367.vod2.myqcloud.com/xxx/xxx/xxx1.jpg"
                            },
                            {
                                "TimeOffset":6,
                                "Url":"http://1256768367.vod2.myqcloud.com/xxx/xxx/xxx2.jpg"
                            },
                            {
                                "TimeOffset":9,
                                "Url":"http://1256768367.vod2.myqcloud.com/xxx/xxx/xxx3.jpg"
                            }
                        ]
                    }
                }
            },
            {
                "Type":"SampleSnapshot",
                "SampleSnapshotTask":{
                    "Status":"SUCCESS",
                    "ErrCode":0,
                    "Message":"",
                    "Input":{
                        "Definition":10
                    },
                    "Output":{
                        "Definition":10,
                        "SampleType":"Percent",
                        "Interval": 10,
                        "WaterMarkDefinition": [],
                        "ImageUrlSet": [
                                "http://1256768367.vod2.myqcloud.com/xxx/xxx/xxx1.jpg",
                                "http://1256768367.vod2.myqcloud.com/xxx/xxx/xxx2.jpg",
                                "http://1256768367.vod2.myqcloud.com/xxx/xxx/xxx3.jpg",
                                "http://1256768367.vod2.myqcloud.com/xxx/xxx/xxx4.jpg",
                                "http://1256768367.vod2.myqcloud.com/xxx/xxx/xxx5.jpg",
                                "http://1256768367.vod2.myqcloud.com/xxx/xxx/xxx6.jpg",
                                "http://1256768367.vod2.myqcloud.com/xxx/xxx/xxx7.jpg",
                                "http://1256768367.vod2.myqcloud.com/xxx/xxx/xxx8.jpg",
                                "http://1256768367.vod2.myqcloud.com/xxx/xxx/xxx9.jpg"
                        ]
                    }
                }
            },
            {
                "Type":"ImageSprites",
                "ImageSpriteTask":{
                    "Status":"SUCCESS",
                    "ErrCode":0,
                    "Message":"",
                    "Input":{
                        "Definition":10
                    },
                    "Output":{
                        "Definition":10,
                        "Height":80,
                        "Width":142,
                        "TotalCount":1,
                        "ImageUrlSet":[
                            "http://1256768367.vod2.myqcloud.com/xxx/xxx/xxx1.jpg"
                        ],
                        "WebVttUrl":"http://1256768367.vod2.myqcloud.com/xxx/xxx/xxx.vtt"
                    }
                }
            },
            {
                "Type":"CoverBySnapshot",
                "CoverBySnapshotTask":{
                    "Status":"SUCCESS",
                    "ErrCode":0,
                    "Message":"",
                    "Input":{
                        "Definition":10,
                        "PositionType":"Time",
                        "PositionValue":0
                    },
                    "Output":{
                        "CoverUrl":"http://1256768367.vod2.myqcloud.com/xxx/xxx/xxx.jpg"
                    }
                }
            }
        ],
        "TasksPriority":0,
        "TasksNotifyMode":""
    }
}

回调结果中，ProcedureStateChangeEvent.MediaProcessResultSet有Type为SnapshotByTimeOffset、SampleSnapshot、ImageSprites和CoverBySnapshot的结果，分别代表指定时间点截图、采样截图、截雪碧图和截取一张图作封面几种截图任务。