本文说明了截图中的常见问题和对应的解决方法。

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

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

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

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

  • 指定截图时间超过视频时长
    • 单张截图
      • 普通截图返回失败。
      • 关键帧截图根据定义,返回截取输入的截图时间附近最近的关键帧图片。
    • 多张截图

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

  • m3u8文件截图

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

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

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

  • 图片大小设置
    1. 截图支持对输出图片进行宽高设置,详情请参见SnapshotConfig参数详情的width(宽)、height(高)参数。
    2. width、height均不设置,则按照视频的分辨率作为图片大小。
    3. width、height只设置一个,则按照输入文件的宽高比进行缩放。
  • 截图任务报错排查
    截图任务错误码主要包含SnapshotTimeOut、InvalidParameter.ResourceNotFound、InvalidParameter.ResourceContentBad等,详情请参见提交截图作业
    1. 错误码获取方式

      提交截图任务失败可以通过查询截图任务接口来获取失败原因,详情请参见查询截图作业

    2. 主要错误常见原因
      1. InvalidParameter.ResourceNotFound,输入文件找不到,确保输入文件存在指定区域的对应bucket,特别注意各region之间的数据是相互独立的。
      2. SnapshotTimeOut,截图超时,此错误由同步截图返回,目前提交截图作业6s返回,如果同步截图超时情况频繁时,建议采用异步方式截图避免超时情况,不建议重试。
      3. InvalidParameter.ResourceContentBad,截图文件内容已经损坏,或者不符合规格导致截图失败。首先确保输入文件内容正常,其次保证截图配置是否符合规格,可按照本文中常见问题一一对照,特别注意截图时间点,关键帧等信息。