文档中心

截图模板

最近更新时间：2023.07.12 13:59:14

首次发布时间：2021.02.23 10:42:41

本文为您介绍截图模板的功能介绍和操作步骤。您可以根据业务需求，对文件进行处理。

功能介绍

视频点播支持配置截取静态图、采样截图、动图、反复循环动图、智能封面（AI 动图）、雪碧图等多种图片，可用于作为各种类型的视频封面、视频预览图。

静态图、反复循环动图截取之后主要应用为视频封面的候选。
采样截图可以将视频中截取 N 张图。支持的截取方式有按时间间隔截图和按张数均匀截图。
动图是把视频片段转换为 webp 或 gif 格式的动图。
雪碧图可以将多张截图拼接为一张图片，用于播放器进度条拖动时预览效果，实现一次性获取多张截图。

操作步骤

进入创建模板页面

登录视频点播控制台，进入空间。
单击左侧导航栏媒体处理设置 > 媒体处理模板，进入媒体处理模板页面。
选择截图模板页签，单击添加截图模板按钮，进入创建截图模板页面。
根据页面提示完成参数配置。详细的参数说明请见截图参数参考。

截图参数参考

配置基础信息

参数	说明
模板名称	必填项。长度不能超过 64 个字符。建议使用可以标识模板内容的名称。
模板描述	选填项。长度不能超过 140 个字符。模板的详细描述。
截图类型	必选项。支持选择静态图、采样截图、动图、反复循环动图、智能封面（AI 动图）、雪碧图。

选择的截图类型不同，需要配置的参数也不同。

配置静态图参数

参数	说明
图片格式	当截图类型为静态图时，图片格式为 jpeg。
图片尺寸	支持配置 2 种尺寸。按短边缩小：固定短边尺寸，按比例缩小。自定义设置短边尺寸，尺寸范围为 [1,4096]，单位为 px。固定尺寸：居中裁剪。自定义设置宽和高的像素值。取值范围为 [0,4096]。当某边的像素值为 0 时，则使用原图的长宽像素值。
截取时间点	设置截取静态图的时间点。单位为 ms。

参数

说明

图片格式

当截图类型为静态图时，图片格式为 jpeg。

图片尺寸

支持配置 2 种尺寸。

按短边缩小：固定短边尺寸，按比例缩小。自定义设置短边尺寸，尺寸范围为 [1,4096]，单位为 px。
固定尺寸：居中裁剪。自定义设置宽和高的像素值。取值范围为 [0,4096]。当某边的像素值为 0 时，则使用原图的长宽像素值。

截取时间点

设置截取静态图的时间点。单位为 ms。

配置采样截图参数

参数	说明
图片格式	当截图类型为采样截图时，图片格式为 jpeg。
图片尺寸	支持配置 2 种尺寸。按短边缩小：固定短边尺寸，按比例缩小。自定义设置短边尺寸，尺寸范围为 [1,4096]，单位为 px。固定尺寸：居中裁剪。需设置宽和高的像素值。取值范围为 [0,4096]，当像素值为 0 时，则使用该边在原图中的像素。
填充方式	默认为保持原视频尺寸。支持的选项有保持原视频尺寸、拉伸和黑边。说明当模板配置的宽 * 高参数与原始视频的宽高比不一致时，对采样截图有不同的填充方式。
截图方式	支持 2 种选择。按时间间隔截图、按张数均匀截图。选择按时间间隔截图，展示截图时间间隔，默认为 10s。根据固定时间间隔采样截图，时间间隔需大于 0，最多支持 50 张。选择按张数均匀截图，展示截取总张数，默认为 10。最大值为 50。根据截图总张数平均时间间隔截图。
随机截图	开关按钮。默认均匀截图。开启后，在每个截图区间内随机截图。
截图输出方式	支持 2 种选择。截图 uri、截图地址文件。截图 uri：返回每张截图的明细 uri 地址，截图上限 50 张，获取截图结果：DirectUrl 模式获取截图说明、Vid 模式获取截图说明截图地址文件：所有截图的 uri 地址存储在一个文件中，截图上限 3 万张，获取截图结果：DirectUrl 模式获取截图说明、Vid 模式获取截图说明

配置动图参数

参数	说明
图片格式	截图类型为动图时，图片格式可选择 gif、webp。
图片尺寸	支持配置 2 种尺寸。按短边缩小：固定短边尺寸，按比例缩小。自定义设置短边尺寸，尺寸范围为 [1,4096]，单位 px。固定尺寸：居中裁剪。自定义设置宽和高的像素值。取值范围为 [0,4096]，当像素值为 0 时，则使用该边在原图中的像素。
截取时间点	设置开始截取动图的时间点。
截取时长	设置动图截取时长（ms）。默认为 5000ms。取值为正整数，最多不超过 100000ms。
动图帧率	帧率越高，连贯性越强，输出文件越大。默认为 10。单位为帧/秒。取值范围为 [10,60]。
动图倍速	默认为 1。取值范围为 [0.5,2]。

配置反复循环动图参数

参数	说明
图片格式	截图类型为反复循环动图时，图片格式为 webp。
图片尺寸	支持配置 2 种尺寸。按短边缩小：固定短边尺寸，按比例缩小。自定义设置短边尺寸，尺寸范围为 [1,4096]，单位为 px。固定尺寸：居中裁剪。自定义设置宽和高的像素值。取值范围为 [0,4096]，当像素值为 0 时，则使用该边在原图中的像素。
截取时间点	设置开始截取动图的时间点。
截取张数	设置截取的动图张数。默认为 9 张。取值为正整数，最多不超过 100张。
动图帧率	帧率越高，连贯性越强，输出文件越大。默认为 10。单位为帧/秒。取值范围为 [10,60]。

配置智能封面（AI 动图）参数

参数	说明
算法模型	当截图类型为智能封面（AI 动图）时可配置，目前仅支持通用摘要。
图片格式	截图类型为智能封面（AI 动图）时，图片格式为 webp。
图片尺寸	支持配置 2 种尺寸。按短边缩小：固定短边尺寸，按比例缩小。自定义设置短边尺寸，尺寸范围为 [1,4096]，单位为 px。固定尺寸：居中裁剪。自定义设置宽和高的像素值。取值范围为 [0,4096]，当像素值为 0 时，则使用该边在原图中的像素。
截取时长	设置智能封面（AI 动图）截取时长。默认为 5s。取值为正整数，最多不超过 100s。
动图帧率	帧率越高，连贯性越强，输出文件越大。默认为 10。单位为帧/秒。取值范围为 [10,60]。
动图倍速	默认为 1。取值范围为 [0.5,2]。

配置雪碧图参数

参数	说明
图片格式	截图类型为雪碧图时，图片格式为 jpeg。
图片尺寸	设置宽和高的像素值。取值范围为 [0,4096]，当像素值为 0 时，则使用该边在原图中的像素。
截图数量	设置最大截图张数。
截图间隔	设置两张截图的时间间隔。填 0 或者不填时，按视频时长平均截图。说明截图数量和截图间隔不能同时为 0。仅设置截图数量时，按照截图数量平均间隔截图；仅设置截图间隔时，按照固定截图间隔截图，截图数量不固定；同时设置截图数量、截图间隔时，按照固定截图间隔截图，截图张数最多为设置的截图张数值。
小图排列（行*列）	设置单张雪碧图中截图的排列方式。例如，小图按照 2 行 * 2 列排列，截图总数为 10 张，则会生成 3 张雪碧图小图，包含截图数量为 4、4、2。其中，最后一张雪碧图 2 个空位会由黑色背景填充。

后续操作

截图模板创建完成后，支持对模板进行查看、编辑、复制和删除等操作。

说明

详情请见媒体处理模板的通用操作说明。