文档

截图

更新时间:

点播媒体处理截图服务包含普通截图、截取动图和设置智能封面功能。通过阅读本文,您可以了解各截图功能的详情及使用方法。

截图类型说明

普通截图

普通截图是指在视频指定位置截图并生成图片文件。点播媒体处理普通截图功能当前支持以下三种截图类型:

普通截图类型

描述

静态截图

对指定视频截取一定数量的图片,可设置开始截图的时间点、截图的总数、截图的时间间隔以及截取的图片宽高等。

WebVTT

根据所有截图信息生成VTT文件(记录截图的基本信息,例如截图时间、截图地址),例如在播放器进度条缩略图展示时,需要先获取VTT文件内容,解析截图的信息并展示对应的缩略图。支持以下方式存储截图:

  • 截图单张存储:所有截图分开存储,VTT文件内容记录单张截图的相对位置信息、截图时间。

  • 截图拼接存储:所有的截图会先拼接成一张大图统一存储,访问具体图片时需要从VTT文件中解析到图片的位置。

雪碧图

先进行普通截图,然后将普通截图按照一定的排列规则拼成一张大图,即雪碧图。使用雪碧图可以一次获取多张截图的信息,降低访问图片的请求次数,从而加强了业务的效率和性能。

动图

截取动图是对视频中的一个区间内容截取并生成动图文件。点播媒体处理动图截取功能当前支持以下两种动图格式:

动图格式

描述

GIF

兼容性好,常用于网页装饰。

WEBP

文件体积相比GIF小很多,但缺点是部分浏览器不兼容,例如:IE、Safari、iOS Safari(版本:3.2~13.7)、KaiOS浏览器等。

说明
  • 纯音频、视频源文件损坏或封装信息异常等可能会导致无法截取动图。

  • 截取动图耗时与视频文件的大小、时长及动图截取的区间内容时长相关。

智能封面

智能封面是通过对视频内容的理解,结合画面美学和海量生产数据,选出最优的关键帧或关键片段作为视频封面,提升视频点击转化及用户体验。点播媒体处理智能封面功能当前支持以下三种截图类型:

智能封面截图类型

描述

图片封面

选取视频内容效果最优的图片,作为视频的图片封面。

动图封面

提取视频多帧精彩瞬间拼接生成GIF动图,作为视频的动图封面。

视频摘要

提取视频精彩内容片段,融合生成具有代表性的5秒短视频作为封面视频。

创建截图模板

通过控制台创建

  1. 登录智能媒体服务控制台

  2. 在顶部左上角根据实际情况选择地域。

  3. 在左侧导航栏选择点播媒体处理 > 模板管理

  4. 截图页签下根据实际需求创建对应模板。

    • 创建普通截图模板

      image

      参数

      描述

      模板名称

      输入普通截图模板名称。

      截图方式

      选择截图类型为静态截图WebVTT雪碧图

      开始截图时间点

      输入开始截图时间点。

      截图数量

      输入截图数量。

      截图间隔时间

      输入截图间隔时间。如果不输入,则默认按每10秒截1张图片;如果输入为0,则会按视频时长均匀截图,此时截图间隔时间=(视频时长-开始截图时间点)/截图数量。

      尺寸

      输入截图的尺寸,宽、高取值范围:[8,4096],单位:px。

      帧类型

      选择帧类型为普通帧关键帧。如果选择关键帧,将只截取关键帧,如果对应指定时间点为非关键帧,则就近选取关键帧,在同等截图规则条件下,关键帧截图比普通帧截图速度快。

      生成大图

      当截图方式为WebVTT时,选择是否开启生成大图。

      排列

      当截图方式为雪碧图时,输入行列规格,行、列取值范围:[1,10000]。

      大图(雪碧图)外框宽度

      当截图方式为雪碧图时,输入大图(雪碧图)外框宽度,单位:px。

      小图图片间距

      当截图方式为雪碧图时,输入小图图片间距,单位:px。

      背景颜色

      当截图方式为雪碧图时,选择雪碧图的背景颜色。

    • 创建动图模板

      image

      参数

      描述

      模板名称

      输入截取动图模板名称。

      输出格式

      选择截取动图的格式为gifwebp

      帧率

      输入动图帧率,取值范围:[1,30],单位:fps。

      尺寸

      输入截图的尺寸,宽、高取值范围:[8,4096],单位:px。

      画面截取方式

      • 按持续时长:输入开始时间和持续时间,取值范围:[0,86400],单位:秒。

      • 按去首尾:输入开始时间和去掉尾部时间,取值范围:[0,86400],单位:秒。

      横竖屏自适应

      是否开启横竖屏自适应。开启后,系统将输出视频的宽对应输入片源的长边,视频的高对应输入片源的短边。

      扫描模式

      选择扫描模式,取值:

      • interlaced:隔行扫描。

      • progressive:逐行扫描。

    • 创建智能封面模板

      image

      参数

      描述

      模板名称

      输入智能封面模板名称。

      任务类型

      选择任务类型,取值:

      • 图片封面:选取视频内容效果最优的图片,作为视频的图片封面。

      • 动图封面:提取视频多帧精彩瞬间拼接生成GIF动图,作为视频的动图封面。

      • 视频摘要:提取视频精彩内容片段,融合生成具有代表性的5秒短视频作为封面视频。

通过OpenAPI创建

调用接口CreateCustomTemplate,根据实际需求设置参数Type的值,创建用户自定义模板。

创建截图任务

通过控制台创建

  1. 登录智能媒体服务控制台

  2. 在顶部左上角根据实际情况选择地域。

  3. 在左侧导航栏选择点播媒体处理 > 任务管理

  4. 截图页签下根据实际需求选择截图类型,创建对应截图任务。

    • 创建普通截图任务

      image

      参数

      描述

      任务名称

      输入普通截图任务名称。

      文件来源

      选择对象存储OSS或IMS媒资管理中的媒资。

      OSS路径

      当文件来源为对象存储OSS时,选择媒资的OSS路径。

      存储地址

      当文件来源为媒资管理时,选择IMS系统中的存储地址,同时单击添加文件添加该存储地址下的媒资。

      选择模板

      选择普通截图模板。

      输出位置

      • 原存储位置:当文件来源为媒资管理时,处理后文件默认保存至原存储位置。

      • 自定义:自定义输出位置。

      输出地址

      当输出位置为自定义时,选择输出地址。

      输出文件名称

      输入截图文件的名称。

    • 创建动图任务

      image

      参数

      描述

      任务名称

      输入截取动图任务名称。

      文件来源

      选择对象存储OSS或IMS媒资管理中的媒资。

      OSS路径

      当文件来源为对象存储OSS时,选择媒资的OSS路径。

      存储地址

      当文件来源为媒资管理时,选择IMS系统中的存储地址,同时单击添加文件添加该存储地址下的媒资。

      选择模板

      选择截取动图模板。

      输出位置

      • 原存储位置:当文件来源为媒资管理时,处理后文件默认保存至原存储位置。

      • 自定义:自定义输出位置。

      输出地址

      当输出位置为自定义时,选择输出地址。

      输出文件名称

      输入截图文件的名称。

    • 创建智能封面任务

      image

      参数

      描述

      任务名称

      输入智能封面任务名称。

      文件来源

      选择对象存储OSS或IMS媒资管理中的媒资。

      OSS路径

      当文件来源为对象存储OSS时,选择媒资的OSS路径。

      存储地址

      当文件来源为媒资管理时,选择IMS系统中的存储地址,同时单击添加文件添加该存储地址下的媒资。

      选择模板

      选择智能封面模板。

      输出位置

      • 原存储位置:当文件来源为媒资管理时,处理后文件默认保存至原存储位置。

      • 自定义:自定义输出位置。

      输出地址

      当输出位置为自定义时,选择输出地址。

      输出文件名称

      输入封面文件的名称。

通过OpenAPI创建

分别调用接口SubmitSnapshotJobSubmitDynamicImageJobSubmitIProductionJob提交普通截图、截取动图或设置智能封面任务,其中普通截图、截取动图接口支持设置参数OverwriteParams覆盖重置模板对应参数。

查询截图任务详情

通过回调信息查询

通过接收视频截图完成视频动图完成AI生产完成(智能封面任务完成时相关的回调)时的回调,查询截图任务详情。更多信息,请参见回调事件概述

通过OpenAPI查询

分别调用GetSnapshotJobGetDynamicImageJobQueryIProductionJob查询普通截图、截取动图或设置智能封面的任务详情。

API参考

  • 本页导读 (1)
文档反馈