全部产品
云市场

视频截图

更新时间:2018-12-12 16:00:34

简介

视频截图,是指在指定视频特定位置的进行图像截取,并生成图片文件。

注意:

  • 纯音频且无任何图像信息流的媒体文件、源文件损坏或源文件封装信息异常,则可能无法生成截图文件。
  • 截图的过程是完全异步的,可接收 截图完成 消息获取截图结果。
  • 截图耗时与文件的大小、时长以及截图采用的 帧类型 有关。

使用说明

封面截图

视频上传完成后,点播会默认进行封面截图,该类截图为 封面截图。且该处理过程完全免费。

API截图

通过提交截图作业接口发起对指定视频的截图任务,详细请参考 提交媒体截图作业。该方式可以截取 普通截图雪碧截图

如何获取截图

目前,视频点播支持通过一下三种方式获取视频的截图信息。

如何删除截图

目前视频点播暂不支持截图单独管理,只随视频进行管理,即删除视频会将对应的截图信息以及截图文件都删掉,且数据不可恢复。

截图类型

封面截图(CoverSnapshot)

视频点播对每一个视频源片都会进行截图,该类截图为封面截图,默认按照视频关键帧平均截取最多8张图片,且截图时间点是从视频的第5ms开始。封面截图可在视频点播控制台视频管理详情页查看,可选择其中任意一张作为视频封面。

注意:

  • 如果视频的关键帧数量不够8个,截图数将不足8张
  • 如果视频没有设置封面,则默认会使用封面截图的中间一张设置为视频封面。

普通截图(NormalSnapshot)

通过API对指定视频截取一定数量的图片,可设置开始截图的时间点、截图的总数、截图的时间间隔以及截取的图片宽高等。如果对视频通过API重复发起截图,视频点播只会记录最新的截图数据。详细请参考 提交媒体截图作业

雪碧截图(SpriteSnapshot)

所谓雪碧图是指先进行普通截图,然后将普通截图按照一定的排列规则拼成一张大图,而这张大图即为雪碧图,而此时的普通截图又称组成 雪碧图的原始图。例如:按照10行,10列规则对普通图进行排列,则一张雪碧图中的小图理论数目为10 * 10 = 100张,由于受限于普通截图的实际张数,雪碧图中小图数目可能不够100张,而如果超过100张则会再次生成第二张雪碧图,以此类推。截取雪碧图的优势在于可降低图片的请求数量,而可以通过请求雪碧图一次获取多张截图的信息,加强了客户端的性能。如下图示意:

普通截图总数为:50,按照10 * 3排列,第一张雪碧图中小图数为30,则第二张雪碧图中小图数为20。

雪碧图原始图(SpriteOriginSnapshot)

雪碧图原始图,即用来拼接雪碧图的普通截图,对于这些原始截图,可以选择删除或者保留,如果保留可以通过查询截图数据接口获取,详细请参考 查询截图数据

截图模板

截图涉及到的参数相对较多,如果将诸多截图参数都统一在提交截图任务时传入,不仅加大了截图功能接入门槛,更降低了易用性。因此视频点播提供了截图模板,用户可先将相关参数配置成截图模板,在发起截取任务时指定截图模板ID即可。

截图模板管理

暂时只支持通过接口进行管理,详细请参考 截图模板 接口。

截图参数

普通截图配置

本节只介绍普通截图配置的部分参数使用细节,更多参数详情请参考 SnapshotConfig

FrameType 帧类型

截图截取的帧类型:关键帧(intra)、普通帧(normal)。

说明:在同等截图规则条件下,一般关键帧截图比普通帧截图速度要快。

SpecifiedOffsetTime 开始时间

截图开始的时间点。正整数类型,单位:毫秒。

注意:如果是单帧截图,则SpecifiedOffsetTime为截图的时间点。

Count 截图总数

截图总数。

Interval 截图间隔

截取多张截图时,截图之间的时间间隔。

Count、Interval说明:

  • Count > 1,表示按照间隔时间截取到指定的Count数。
  • Count > 1,Interval = 0,表示在视频时长范围内按照Count值截图,如果FrameType=intra,关键帧数小于Count数,则截图实际总数 < Count。
  • Count = 1,截取单帧截图。

Width 截图宽

截图的宽。单位:像素。

Height 截图高

截图的高。单位:像素。

Width、Height说明:

  • 不设置宽和高,截图宽高与输入视频宽高相同。
  • 如果只设置宽或者高,则没有设置的一边按照输入视频的画面比例进行缩放,维持图片不变形。

雪碧截图配置

本节内容只对雪碧图的部分参数使用细节进行说明,更多参数详情请参考 SpriteSnapshotConfig

CellWidth(小图宽)、CellHeight(小图高)

雪碧途中的小图宽和高设置参数,如果都不设置则小图宽高为普通截图的宽高,如果只设置其中一个,则另一边按照比例缩放。

KeepCellPic 是否删除原始图

是否保留构成雪碧图的原始图,即截图的普通截图。取值:delete(删除,即不保留),keep(保留)。

注意:对于雪碧图截取,如无特殊需求,建议不保留构成雪碧图的原始图。

Color 雪碧图背景色

生成雪碧图的背景颜色。详细取值请参考 颜色参数

说明:暂不支持RGB参数值。

雪碧图参数示意如下:

雪碧图参数