截图模板

更新时间:
复制为 MD 格式

视频点播提供预设参数的截图模板,用于在媒体处理工作流中自动执行视频截图。本文介绍截图方式选择、模板创建与管理,以及如何在工作流中使用模板实现自动化截图。

截图方式对比

截图方式分为普通截图WebVTT雪碧图,详情请参见视频截图

截图方式

适用场景

优缺点

普通截图

视频封面、内容审核、精彩瞬间分享。

优点
灵活性高,适用于需要单张图片的场景。

缺点
若截图数量多,会产生大量文件和HTTP请求,影响加载性能。

WebVTT

Web/H5播放器进度条悬停时显示预览图。

优点:适配Web/H5播放器进度条预览。

缺点
用途单一,无法作为独立图片使用。

雪碧图

移动端或需要极致加载性能的播放器预览图场景。

优点
减少HTTP请求数,优化前端加载性能,适合移动端场景。

缺点
配置流程相对复杂,且单张小图无法直接引用。

创建截图模板

  1. 登录视频点播控制台

  2. 在左侧导航栏选择配置管理 > 媒体处理配置 > 截图模板,进入截图模板页面。

  3. 单击添加截图模板,在添加截图模板页面,根据业务需求配置截图模板。

    重要

    截图方式(普通截图/WebVTT/雪碧图)在创建模板后不可修改,请在保存前确认选择。

    配置

    通用参数

    以下参数适用于所有截图方式。

    参数

    说明

    模板名称

    模板的自定义名称,用于在工作流中识别和引用。

    起始时间点

    截图开始的时间点(时:分:秒)。

    截图数量

    期望生成的截图总数。

    截图间隔时间

    多张截图时的时间间隔。填0或留空时,按视频时长均分截取。

    尺寸(宽×高)

    截图的宽和高。单位:像素。

    说明
    • 未设置宽高时,截图尺寸与输入视频宽高相同。

    • 仅设置宽或高时,未设置边按视频比例自动缩放,保持画面不变形。

    帧类型

    截图截取的帧类型包括:关键帧、普通帧。

    说明

    选择关键帧类型时,仅截取关键帧;若指定时间点无关键帧,则自动选取最近关键帧。同等条件下,关键帧截图比普通帧更快。

    WebVTT 专属参数

    参数

    说明

    生成大图

    是否将WebVTT所需的多张缩略图拼接成大图存储。

    雪碧图专属参数

    参数

    说明

    排列(行×列)

    雪碧图中的小图宽和高设置参数。

    说明

    未设置时小图宽高与普通截图相同;仅设置一边时,另一边等比缩放。

    行间距

    雪碧图中各行小图之间的垂直间距,单位:像素。

    列间距

    雪碧图中各列小图之间的水平间距,单位:像素。

    背景颜色

    生成雪碧图的背景颜色。

    保留小图

    是否在生成雪碧图的同时,保留构成雪碧图的原始图。

  4. 配置完成后,单击保存

工作流中使用截图模板

创建后需要将截图模板添加到工作流中,在上传媒体或媒体处理环节使用。

  1. 绑定到工作流。

    登录视频点播控制台,进入配置管理 > 媒体处理配置 > 工作流管理,添加或编辑一个工作流,在节点中插入视频截图节点,并在右侧节点配置中选择已创建的截图模板。

  2. 触发工作流。

    绑定完成后,可通过以下方式触发工作流。

    1. 自动触发:在上传音视频时,指定该工作流。音视频上传完成后,工作流将自动执行。详情请参见通过视频点播控制台上传文件

    2. 手动触发:在媒资库 > 音/视频页面,选择目标媒资,单击媒体处理,选择用工作流处理并指定该工作流。

    3. API触发:调用提交点播工作流作业接口指定该工作流作业。

  3. 获取截图结果。

    可以通过视频截图完成事件通知获取截图结果。当视频截图成功后,系统会向配置的地址发送回调消息,消息体中包含了截图数据列表。

计费说明

视频点播的截图功能完全免费。

常见问题

没有收到截图完成事件如何排查

可以通过以下步骤排查:

  1. 确认输入视频的状态是否正常,视频文件是否损坏。

  2. 确认截图模板中的参数是否合理,例如起始时间点是否超出了视频时长。

  3. 确认事件通知回调配置是否正确,详情请参见事件通知

如何通过API直接使用截图模板

可以通过提交媒体截图作业独立发起截图任务。