智能多媒体 API

  • 视频帧缩略图

    最近更新时间:2017-07-12 16:04:40

    视频帧缩略图接口(vframe)用于从视频流中截取指定时刻的单帧画面并按指定大小缩放成图片。

    接口规格

    vframe/<Format>
          /offset/<Second>
          /w/<Width>
          /h/<Height>
          /rotate/<Degree>
    
    参数名称 必填 说明
    <Format> 输出的目标截图格式,支持jpgpng等。
    /offset/<Second> 指定截取视频的时刻,单位:秒,精确到毫秒。
    /w/<Width> 缩略图宽度,单位:像素(px),取值范围为1-3840。
    /h/<Height> 缩略图高度,单位:像素(px),取值范围为1-2160。
    /rotate/<Degree> 指定顺时针旋转的度数,可取值为90180270auto,默认为不旋转。

    请求语法

    可以通过预转持久化数据处理或者持久化数据处理的方式来调用

    示例

    取视频第7秒的截图,图片格式为jpg,宽度为480px,高度为360px:

    预转持久化数据处理上传的token中指定persistentOps:

    {
          "scope":                "qiniu-ts-demo:thinking-in-go.mp4",
          "deadline":             1390528576,
          "persistentOps":        "vframe/jpg/offset/7/w/480/h/360",
          "persistentNotifyUrl":  "http://fake.com/qiniu/notify"
    }
    

    持久化数据处理(即触发持久化):

    POST /pfop/ HTTP/1.1
    Host: api.qiniu.com  
    Content-Type: application/x-www-form-urlencoded  
    Authorization: QBox <AccessToken>  
    
    bucket=qiniu-ts-demo
    &key=thinking-in-go.mp4
    &fops=vframe%2fjpg%2foffset%2f7%2fw%2f480%2fh%2f360
    

    注意:视频帧缩略图(vframe)不仅支持持久化数据处理的异步处理方式而且支持同步处理方式。

    以 Python Sdk 为例,具体可以看下音视频转码的示例。需要在音视频转码的示例的基础修改数据处理命令 fops ,将其修改为:

    fops = vframe%2fjpg%2foffset%2f7%2fw%2f480%2fh%2f360
    

    注意: 其他语言 Sdk 可在官方 Sdks 下载,可以通过查看 Sdk 使用指南中触发持久化预转持久化使用。

    以上内容是否对您有帮助?
  • 提交工单