视频截图
能力介绍¶
视频截图，是指在指定视频特定的位置进行图像截取，并生成图片文件。
纯音频且无任何图像信息流的媒体文件、源文件损坏或源文件封装信息异常，则可能无法生成截图文件。截图耗时与文件的大小、时长以及截图采用的帧类型有关。
截图类型¶
- 封面截图（CoverSnapshot）
视频点播对每一个视频源片都会进行截图，该类截图为封面截图，默认按照视频关键帧平均截取最多8张图片，且截图时间点是从视频的第5ms开始。封面截图可在视频点播控制台视频管理详情页查看，可选择其中任意一张作为视频封面。
- 普通截图（NormalSnapshot）
对指定视频截取一定数量的图片，可设置开始截图的时间点、截图的总数、截图的时间间隔以及截取的图片宽高等。
- 雪碧截图（SpriteSnapshot）
所谓雪碧图是指先进行普通截图，然后将普通截图按照一定的排列规则拼成一张大图，而这张大图即为雪碧图，而此时的普通截图又称组成雪碧图的原始图。截取雪碧图的优势在于可降低图片的请求数量，从而可以通过请求雪碧图一次获取多张截图的信息，加强了客户端的性能。例如：按照10行、10列规则对普通图进行排列，则一张雪碧图中的小图理论数目为10×10 =100张，由于受限于普通截图的实际张数，雪碧图中小图数目可能不够100张，而如果超过100张则会再次生成第二张雪碧图，以此类推。如下图示意：
- 雪碧图原始图（SpriteOriginSnapshot）
雪碧图原始图，即用来拼接雪碧图的普通截图，对于这些原始截图，可以选择删除或者保留
功能特性¶
- 截取指定时间的图片
- 支持同时指定多个时间点
参数说明¶
| 参数名称 | 参数标识 | 参数类型 | 参数说明 |
|---|---|---|---|
| 输入视频 | inputVideo | 字符串 string |
输入视频的路径 |
| 截图时间点 | time | 字符串 string |
截图时间点 |
| 截图文件 | outputImage | 字符串 string |
输出的截图文件 |