TargetImage

名称类型描述示例值
object

截帧、雪碧图或动图目标图片信息。

Spritesarray<object>

雪碧图处理列表。

object

雪碧图处理详细信息。

ScaleTypestring

缩放方式。取值范围如下:

  • stretch(默认):拉伸以填满。

  • crop:缩放并裁剪。

  • fill:缩放并保留黑边。

  • fit:缩放并不保留黑边。

crop
Modestring

雪碧图子图截帧模式,取值范围如下:

  • interval(默认):固定时间间隔模式,截帧间隔由 Interval 参数决定。
  • keyframe:关键帧模式,仅截取源视频中的 IDR 帧,此时 Interval 参数无效。
  • average:平均模式,根据 Number 参数按均匀时间间隔截帧,此时 Interval 参数无效。
  • dhash:dhash 模式,根据 Number 参数设置,在固定时间间隔截帧的基础上截取视频帧内容变化超过 Threshold 参数的 Top Number 帧。
    说明 当 Number 参数为 0 时,则截取所有视频帧内容变化超过 Threshold 参数的帧。
interval
StartTimedouble

视频截帧的开始时间,单位为秒(s)。默认值为 0,表示从视频起始时间开始。

0
TileHeightinteger

每列包含的图片数量,默认值为 6。

6
URIstring

保存雪碧图的 OSS 地址。

地址规则为 oss://bucket/object,其中 bucket 为和当前项目处于同一地域的 OSS Bucket 名称,object 为包含文件扩展名的文件完整路径。

oss://test-bucket/sprites
ScaleWidthfloat

单张图片的宽度,默认值为 1,取值为整数或小数时的不同含义如下:

  • 整数:像素值,单位为像素(px),取值范围为(1,4096)。

  • 小数:表示相对输出视频分辨率宽度的比率,取值范围为(0,1]。

1280
Padinteger

小图之间的间隔,默认值为 2。

2
Formatstring

雪碧图的格式。取值范围如下:

  • jpg

  • png

jpg
Numberinteger

小图数量。默认值为 0,表示截取到视频结束位置。

0
ScaleHeightfloat

单张图片的高度,默认值为 1,取值为整数或小数时的不同含义如下:

  • 整数:像素值,单位为像素(px),取值范围为(1,4096)。

  • 小数:表示相对输出视频分辨率高度的比率,取值范围为(0,1]。

960
TileWidthinteger

每行包含的图片数量,默认值为 6。

6
Intervaldouble

视频截帧的时间间隔,单位为秒(s)。

1
Margininteger

小图和雪碧图边缘的间隔,默认值为 2。

2
Thresholdinteger

截帧阈值,值越大截帧数量越少,取值范围为 0~100,默认值为 0。

说明
  • 仅在使用 dhash 截帧模式时有效。
  • dhash 模式对阈值较为敏感,推荐该参数设置不大于 25,并根据具体场景调整。
  • 0
    Animationsarray<object>

    动图处理列表。

    object

    动图处理详细信息。

    FrameRatedouble

    动图帧率。可以配合 Interval 实现加减速。

    25
    Formatstring

    输出动图格式。取值范围如下:

    • gif
    • webp
    gif
    Numberinteger

    抽帧数量。0 表示到末尾,默认 0。

    100
    ScaleTypestring

    缩放方式。取值范围如下:

    • stretch(默认):拉伸以填满。

    • crop:缩放并裁剪。

    • fill:缩放并保留黑边。

    • fit:缩放并不保留黑边。

    crop
    StartTimedouble

    动图抽帧起始时间,单位秒。默认 0。

    0
    Heightdouble

    动图高度。默认保持原高度。取值为整数或小数时的不同含义如下:

    • 整数:代表像素值,单位为 px,取值范围为[1,4096]。
    • 小数:代表相对输出图片分辨率高度的比率,取值范围为(0,1)
    960
    URIstring

    保存动图的 OSS 地址。

    地址规则为 oss://bucket/object,其中 bucket 为和当前项目处于同一地域的 OSS Bucket 名称,object 为包含文件扩展名的文件完整路径。

    oss://test-bucket/animations
    Widthdouble

    动图宽度。默认保持原宽度。取值为整数或小数时的不同含义如下:

    • 整数:代表像素值,单位为 px,取值范围为[1,4096]。
    • 小数:代表相对输出图片分辨率宽度的比率,取值范围为(0,1)
    1280
    Intervaldouble

    抽帧间隔,单位为秒。

    0.5
    Snapshotsarray<object>

    截帧处理列表。

    object

    截帧处理详细信息。

    Formatstring

    截帧的格式。取值范围如下:

    • jpg

    • png

    jpg
    Numberinteger

    截帧数量。默认值为 0,表示截取到视频结束位置。

    10
    ScaleTypestring

    缩放方式。取值范围如下:

    • stretch(默认):拉伸以填满。

    • crop:缩放并裁剪。

    • fill:缩放并保留黑边。

    • fit:缩放并不保留黑边。

    crop
    Modestring

    雪碧图子图截帧模式,取值范围如下:

    • interval(默认):固定时间间隔模式,截帧间隔由 Interval 参数决定。
    • keyframe:关键帧模式,只截取源视频中的 IDR 帧,此时 Interval 参数无效。
    • average:平均模式,根据 Number 参数按均匀时间间隔截帧,此时 Interval 参数无效。
    • dhash:dhash 模式,根据 Number 参数设置,在固定时间间隔截帧的基础上截取视频帧内容变化超过 Threshold 参数的 Top Number 帧。
      说明 当 Number 参数为 0 时,则截取所有视频帧内容变化超过 Threshold 参数的帧。
    interval
    StartTimedouble

    视频截帧的开始时间,单位为秒(s)。默认值为 0,表示从视频起始时间开始。

    0
    Heightdouble

    图片高度,默认保持源视频高度。取值为整数或小数时的不同含义如下:

    • 整数:像素值,单位为像素(px),取值范围为[1,4096]。

    • 小数:表示相对输出图片分辨率高度的比率,取值范围为(0,1)。

    960
    URIstring

    保存截帧的 OSS 地址。

    地址规则为 oss://bucket/object,其中 bucket 为和当前项目处于同一地域的 OSS Bucket 名称,object 为包含文件扩展名的文件完整路径。

    oss://test-bucket/snapshots
    Widthdouble

    图片宽度,默认保持源视频宽度。取值为整数或小数时的不同含义如下:

    • 整数:像素值,单位为像素(px),取值范围为[1,4096]。

    • 小数:表示相对输出图片分辨率宽度的比率,取值范围为(0,1)。

    1280
    Intervaldouble

    视频截帧的时间间隔,单位为秒(s)。

    0.5
    Thresholdinteger

    截帧阈值,值越大截帧数量越少,取值范围为 0~100,默认值为 0。

    说明
  • 仅在使用 dhash 截帧模式时有效。
  • dhash 模式对阈值较为敏感,推荐该参数设置不大于 25,并根据具体场景调整。
  • 0