全部产品
Search
文档中心

截图常见问题

更新时间: 2017-12-28

一般性问题

什么是截图?

截图,是指对输入文件一般指视频文件,根据对应的截图配置,截取相应的图片。

MTS支持的截图方式

MTS截图服务支持2种方式

截图模式

  • 同步模式

    接口同步返回截图结果,截图在接口返回时就已经生成到对应的Bucket。

  • 异步模式

    不保证接口返回时截图已经生成,截图任务将进入后台排队,异步执行截图。只要设置了Interval和Num中的任何一个参数,就表示异步模式。设置PipelineId参数,保证管道上配有相应消息,截图完成后将发送异步消息。

截图类型

  • 普通帧 :nomal

  • I帧,也称关键帧:intra。关键帧截图就是截取输入的截图时间附近最近的关键帧图片。

截图场景

  • 单张截图 num=1 或者不设置

  • 多张截图 : num>1 或者 Interval>0

  • 平均截图 :Interval=0,num>1

截图支持的图片格式

目前支持生成jpg格式图片

使用过程中常见问题答疑

提交截图任务如何区分同步异步

只要设置了Interval和Num中的任何一个参数,就表示异步模式,跟是否设置piplineId无关,详情参考 参数详情 中“11.SnapshotConfig参数详情”。

指定截图时间点不是关键帧时如何处理

获取截图时间附近最近的关键帧。如果是多张截图,截图时间附近找不到相应关键帧图片,则不返回相应时间点对应的图片,出现返回的图片张数与设定张数不一致情况。

指定截图时间超过视频时长

  • 单张截图

    • 普通截图返回失败

    • 关键帧截图根据定义,返回截取输入的截图时间附近最近的关键帧图片。

  • 多张截图

    Time+Interval*Num的截取点超过视频时长时,后续截图自动失效,截图完成时返回实际截取的个数

m3u8文件截图

同步截图必须保证m3u8索引中的ts路径与m3u8在相同的路径下,异步无要求

序列截图返回的截图数量少于设置值

对应时间点附近不存在关键帧图片;后续截图时间点已超出了输入文件总时长;

图片大小设置

  • 截图支持对输出图片进行宽高设置,详情参考 参数详情 中“11SnapshotConfig参数详情” width,height

  • width,height均不设置,则按照视频的分辨率作为图片大小

  • width,height只设置一个,则按照输入文件的宽高比进行缩放

截图任务报错排查

截图任务错误码主要包含SnapshotTimeOut,InvalidParameter.ResourceNotFound,InvalidParameter.ResourceContentBad等,详情参考 提交截图作业

  • 错误码获取方式

    • 提交截图任务失败

      可以通过查询截图任务接口来获取失败原因,详情参考 查看截图作业 QuerySnapshotJobList接口返回

    • 工作流截图失败登录MTS控制台—媒体库—选择相应的执行实例查看截图活动具体失败原因

  • 主要错误常见原因

    • InvalidParameter.ResourceNotFound,输入文件找不到,确保输入文件存在指定区域的对应bucket,特别注意各region之间的数据是相互独立的。

    • SnapshotTimeOut,截图超时,此错误由同步截图返回,目前提交截图作业6s返回,如果同步截图超时情况频繁时,建议采用异步方式截图避免超时情况,不建议重试。

    • InvalidParameter.ResourceContentBad,截图文件内容已经损坏,或者不符合规格导致截图失败。首先确保输入文件内容正常,其次保证截图配置是否符合规格,可按照本文中常见问题一一对照,特别注意截图时间点,关键帧等信息。