视频点播提供预设参数的截图模板,用于在媒体处理工作流中自动执行视频截图。本文介绍截图方式选择、模板创建与管理,以及如何在工作流中使用模板实现自动化截图。
截图方式对比
截图方式分为普通截图、WebVTT和雪碧图,详情请参见视频截图。
截图方式 | 适用场景 | 优缺点 |
普通截图 | 视频封面、内容审核、精彩瞬间分享。 | 优点: 缺点: |
WebVTT | Web/H5播放器进度条悬停时显示预览图。 | 优点:适配Web/H5播放器进度条预览。 缺点: |
雪碧图 | 移动端或需要极致加载性能的播放器预览图场景。 | 优点: 缺点: |
创建截图模板
登录视频点播控制台。
在左侧导航栏选择配置管理 > 媒体处理配置 > 截图模板,进入截图模板页面。
单击添加截图模板,在添加截图模板页面,根据业务需求配置截图模板。
重要截图方式(普通截图/WebVTT/雪碧图)在创建模板后不可修改,请在保存前确认选择。

通用参数
以下参数适用于所有截图方式。
参数
说明
模板名称
模板的自定义名称,用于在工作流中识别和引用。
起始时间点
截图开始的时间点(时:分:秒)。
截图数量
期望生成的截图总数。
截图间隔时间
多张截图时的时间间隔。填0或留空时,按视频时长均分截取。
尺寸(宽×高)
截图的宽和高。单位:像素。
说明未设置宽高时,截图尺寸与输入视频宽高相同。
仅设置宽或高时,未设置边按视频比例自动缩放,保持画面不变形。
帧类型
截图截取的帧类型包括:关键帧、普通帧。
说明选择关键帧类型时,仅截取关键帧;若指定时间点无关键帧,则自动选取最近关键帧。同等条件下,关键帧截图比普通帧更快。
WebVTT 专属参数
参数
说明
生成大图
是否将WebVTT所需的多张缩略图拼接成大图存储。
雪碧图专属参数
参数
说明
排列(行×列)
雪碧图中的小图宽和高设置参数。
说明未设置时小图宽高与普通截图相同;仅设置一边时,另一边等比缩放。
行间距
雪碧图中各行小图之间的垂直间距,单位:像素。
列间距
雪碧图中各列小图之间的水平间距,单位:像素。
背景颜色
生成雪碧图的背景颜色。
保留小图
是否在生成雪碧图的同时,保留构成雪碧图的原始图。
配置完成后,单击保存。
工作流中使用截图模板
创建后需要将截图模板添加到工作流中,在上传媒体或媒体处理环节使用。
绑定到工作流。
登录视频点播控制台,进入配置管理 > 媒体处理配置 > 工作流管理,添加或编辑一个工作流,在节点中插入视频截图节点,并在右侧节点配置中选择已创建的截图模板。
触发工作流。
绑定完成后,可通过以下方式触发工作流。
自动触发:在上传音视频时,指定该工作流。音视频上传完成后,工作流将自动执行。详情请参见通过视频点播控制台上传文件。
手动触发:在媒资库 > 音/视频页面,选择目标媒资,单击媒体处理,选择用工作流处理并指定该工作流。
API触发:调用提交点播工作流作业接口指定该工作流作业。
获取截图结果。
可以通过视频截图完成事件通知获取截图结果。当视频截图成功后,系统会向配置的地址发送回调消息,消息体中包含了截图数据列表。
计费说明
视频点播的截图功能完全免费。
常见问题
没有收到截图完成事件如何排查
可以通过以下步骤排查:
确认输入视频的状态是否正常,视频文件是否损坏。
确认截图模板中的参数是否合理,例如起始时间点是否超出了视频时长。
确认事件通知回调配置是否正确,详情请参见事件通知。
如何通过API直接使用截图模板
可以通过提交媒体截图作业独立发起截图任务。