tencent cloud

云点播

动态与公告
产品动态
公告
产品简介
产品概述
产品特性
产品功能
产品优势
应用场景
解决方案
专业版
云点播专业版简介
快速入门
控制台指南
开发指南
购买指南
计费概述
计费方式
购买指引
账单查询
续费说明
欠费说明
退费说明
快速入门
控制台指南
控制台介绍
服务概览
应用管理
媒体管理
资源包管理
License 管理
实时日志分析
实践教程
媒体上传
如何将点播的媒体文件进行智能降冷
媒体处理
分发播放
如何接收事件通知
如何进行源站迁移
直播录制
如何进行自定义源站回源
直播精彩剪辑固化至云点播 VOD 指引
如何使用 EdgeOne 分发云点播内容
开发指南
媒体上传
媒体加工处理
媒体 AI
事件通知
媒体分发播放
媒体加密与版权保护
播放频道
访问管理
下载媒体文件
应用体系
错误码
播放器 SDK 文档
概述
基本概念
产品功能
Demo 体验
免费测试
购买指南
SDK 下载
License 指引
播放器教程
含 UI 集成方案
无 UI 集成方案
高级功能
API 文档
第三方播放器插件
Player SDK Policy
服务端 API 文档
History
Introduction
API Category
Other APIs
Media Processing APIs
Task Management APIs
Media Upload APIs
Media Management APIs
Event Notification Relevant API
Media Categorization APIs
Domain Name Management APIs
Distribution APIs
AI-based Sample Management APIs
Region Management APIs
Data Statistics APIs
Carousel-Related APIs
Just In Time Transcode APIs
No longer recommended APIs
Making API Requests
AI-based image processing APIs
Parameter Template APIs
Task Flow APIs
Data Types
Error Codes
Video on Demand API 2024-07-18
常见问题
移动端播放问题
费用相关问题
视频上传问题
视频发布问题
视频播放问题
Web 端播放问题
全屏播放问题
数据统计问题
访问管理相关问题
媒资降冷问题
相关协议
Service Level Agreement
VOD 政策
隐私政策
数据处理和安全协议
联系我们
词汇表

截图

PDF
聚焦模式
字号
最后更新时间: 2023-03-07 11:20:50
截图是截取视频特定位置的图像并生成图片的过程,是一种离线任务。云点播提供以下类型的截图:
指定时间点截图:指定一组时间点,截取视频在这些时间点的图像。
采样截图:按相同的时间间隔对视频截取多张图。
截取一张图作封面:指定一个时间点截图,将其 URL 作为媒资系统中该视频的封面。
截雪碧图:按相同的时间间隔对视频截取多张小图,然后组装成若干大图(即雪碧图)。
使用截图功能,可以满足如下应用场景:
为视频生成封面:使用视频的截图作为视频的封面。
缩略图:雪碧图是嵌套了多个小图(即缩略图)的大图,常用来表示一个视频的概要。
播放预览:雪碧图配合 VTT 文件,可以用来实现播放器进度条上的预览效果。

截图模板

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

时间点截图模板

时间点截图模板,用于“指定时间点截图”和“截取一张图作封面”两种任务。
参数
说明
格式(Format)
截图文件的输出格式,目前仅支持 JPG。
宽度(Width)
截图宽度,范围是128px - 4096px。
高度(Height)
截图高度,范围是128px - 4096px。
填充方式(FillType)
当截图的宽高比与原始视频的宽高比不一致时,对截图的处理方式,即为“填充”。一般有以下几种填充方式:
拉伸:对图片进行拉伸,填满整个图片,可能导致图片被“压扁”或者“拉长”。
留黑:保持图片宽高比不变,边缘剩余部分使用黑色填充。
留白:保持图片宽高比不变,边缘剩余部分使用白色填充。
高斯模糊:保持图片宽高比不变,边缘剩余部分使用高斯模糊化后填充。
针对常见的规格,云点播提供 预置时间点截图模板。另外,您还可以通过控制台创建和管理自定义截图模板,具体操作请参见 模板设置

采样截图模板

采样截图模板,用于“采样截图”任务。
参数
说明
格式(Format)
截图文件的输出格式,目前仅支持 JPG。
宽度(Width)
截图宽度,范围是128px - 4096px。
高度(Height)
截图高度,范围是128px - 4096px。
采样方式(SampleType)
采样方式分为两种:
按百分比采样:例如按照5%为间隔采样,生成截图张数将为20张。
按时间间隔采样:例如按照10s为间隔采样,截图张数取决于视频的时长。
采样间隔(Interval)
采样的间隔长度:
如果按百分比采样,间隔是百分比。
如果按时间间隔采样,间隔是多少秒。
填充方式(FillType)
当截图的宽高比与原始视频的宽高比不一致时,对截图的处理方式,即为“填充”。一般有以下几种填充方式:
拉伸:对图片进行拉伸,填满整个图片,可能导致图片被“压扁”或者“拉长”。
留黑:保持图片宽高比不变,边缘剩余部分使用黑色填充。
留白:保持图片宽高比不变,边缘剩余部分使用白色填充。
高斯模糊:保持图片宽高比不变,边缘剩余部分使用高斯模糊化后填充。
针对常见的规格,云点播提供了 预置采样截图模板。另外,您还可以通过控制台创建和管理自定义截图模板,具体操作请参见 模板设置

雪碧图模板

雪碧图模板,用于“截雪碧图”任务。
参数
说明
格式(Format)
雪碧图文件的输出格式,目前仅支持 JPG。
小图宽度(Width)
雪碧图中小图的宽度。
小图高度(Height)
雪碧图中小图的高度。
小图行数(Rows)
一张大图中有多少行小图。
小图列数(Columns)
一张大图中有多少列小图。
采样方式(SampleType)
小图采样方式,目前仅支持按照时间间隔采样。
采样间隔(Interval)
小图采样的间隔,即隔多久采样一张小图。
注意:
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.MediaProcessResultSetTypeSnapshotByTimeOffsetSampleSnapshotImageSpritesCoverBySnapshot的结果,分别代表指定时间点截图、采样截图、截雪碧图和截取一张图作封面几种截图任务。

帮助和支持

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

填写满意度调查问卷,共创更好文档体验。

文档反馈