截帧雪碧图动图参数数据结构-智能媒体管理-阿里云-智能媒体管理(IMM)-阿里云帮助中心

名称	类型	描述	示例值
	object	截帧、雪碧图或动图目标图片信息
Sprites	array	雪碧图处理列表。
	object	雪碧图处理详细信息。
URI	string	保存雪碧图的 OSS 地址。地址规则为 oss://bucket/object，其中 bucket 为和当前项目处于同一地域的 OSS Bucket 名称，object 为包含文件扩展名的文件完整路径。	oss://test-bucket/sprites
Format	string	雪碧图的格式。取值范围如下： jpg png	jpg
StartTime	number	视频截帧的开始时间，单位为秒（s）。默认值为 0，表示从视频起始时间开始。	0
Interval	number	视频截帧的时间间隔，单位为秒（s）。	1
Number	integer	小图数量。默认值为 0，表示截取到视频结束位置。	0
ScaleWidth	number	单张图片的宽度，默认值为 1，取值为整数或小数时的不同含义如下：整数：像素值，单位为像素（px），取值范围为(1,4096)。小数：表示相对输出视频分辨率宽度的比率，取值范围为(0,1]。	1280
ScaleHeight	number	单张图片的高度，默认值为 1，取值为整数或小数时的不同含义如下：整数：像素值，单位为像素（px），取值范围为(1,4096)。小数：表示相对输出视频分辨率高度的比率，取值范围为(0,1]。	960
TileWidth	integer	每行包含的图片数量，默认值为 6。	6
TileHeight	integer	每列包含的图片数量，默认值为 6。	6
Pad	integer	小图之间的间隔，默认值为 2。	2
Margin	integer	小图和雪碧图边缘的间隔，默认值为 2。	2
ScaleType	string	缩放方式。取值范围如下： stretch（默认）：拉伸以填满。 crop：缩放并裁剪。 fill：缩放并保留黑边。 fit：缩放并不保留黑边。	crop
Mode	string	雪碧图子图截帧模式，取值范围如下： interval（默认）：固定时间间隔模式，截帧间隔由 Interval 参数决定。 keyframe：关键帧模式，仅截取源视频中的 IDR 帧，此时 Interval 参数无效。 average：平均模式，根据 Number 参数按均匀时间间隔截帧，此时 Interval 参数无效。 dhash：dhash 模式，根据 Number 参数设置，在固定时间间隔截帧的基础上截取视频帧内容变化超过 Threshold 参数的 Top Number 帧。说明当 Number 参数为 0 时，则截取所有视频帧内容变化超过 Threshold 参数的帧。	interval
Threshold	integer	截帧阈值，值越大截帧数量越少，取值范围为 0~100，默认值为 0。说明仅在使用 dhash 截帧模式时有效。 dhash 模式对阈值较为敏感，推荐该参数设置不大于 25，并根据具体场景调整。	0
Snapshots	array	截帧处理列表。
	object	截帧处理详细信息。
URI	string	保存截帧的 OSS 地址。地址规则为 oss://bucket/object，其中 bucket 为和当前项目处于同一地域的 OSS Bucket 名称，object 为包含文件扩展名的文件完整路径。	oss://test-bucket/snapshots
Format	string	截帧的格式。取值范围如下： jpg png	jpg
StartTime	number	视频截帧的开始时间，单位为秒（s）。默认值为 0，表示从视频起始时间开始。	0
Interval	number	视频截帧的时间间隔，单位为秒（s）。	0.5
Number	integer	截帧数量。默认值为 0，表示截取到视频结束位置。	10
Width	number	图片宽度，默认保持源视频宽度。取值为整数或小数时的不同含义如下：整数：像素值，单位为像素（px），取值范围为[1,4096]。小数：表示相对输出图片分辨率宽度的比率，取值范围为(0,1)。	1280
Height	number	图片高度，默认保持源视频高度。取值为整数或小数时的不同含义如下：整数：像素值，单位为像素（px），取值范围为[1,4096]。小数：表示相对输出图片分辨率高度的比率，取值范围为(0,1)。	960
ScaleType	string	缩放方式。取值范围如下： stretch（默认）：拉伸以填满。 crop：缩放并裁剪。 fill：缩放并保留黑边。 fit：缩放并不保留黑边。	crop
Mode	string	雪碧图子图截帧模式，取值范围如下： interval（默认）：固定时间间隔模式，截帧间隔由 Interval 参数决定。 keyframe：关键帧模式，只截取源视频中的 IDR 帧，此时 Interval 参数无效。 average：平均模式，根据 Number 参数按均匀时间间隔截帧，此时 Interval 参数无效。 dhash：dhash 模式，根据 Number 参数设置，在固定时间间隔截帧的基础上截取视频帧内容变化超过 Threshold 参数的 Top Number 帧。说明当 Number 参数为 0 时，则截取所有视频帧内容变化超过 Threshold 参数的帧。	interval
Threshold	integer	截帧阈值，值越大截帧数量越少，取值范围为 0~100，默认值为 0。说明仅在使用 dhash 截帧模式时有效。 dhash 模式对阈值较为敏感，推荐该参数设置不大于 25，并根据具体场景调整。	0
Animations	array	动图处理列表。
	object	动图处理详细信息。
URI	string	保存动图的 OSS 地址。地址规则为 oss://bucket/object，其中 bucket 为和当前项目处于同一地域的 OSS Bucket 名称，object 为包含文件扩展名的文件完整路径。	oss://test-bucket/animations
Format	string	输出动图格式。取值范围如下： gif webp	gif
FrameRate	number	动图帧率。可以配合 Interval 实现加减速。	25
StartTime	number	动图抽帧起始时间，单位秒。默认 0。	0
Interval	number	抽帧间隔，单位为秒。	0.5
Number	integer	抽帧数量。0 表示到末尾，默认 0。	100
Width	number	动图宽度。默认保持原宽度。取值为整数或小数时的不同含义如下：整数：代表像素值，单位为 px，取值范围为[1,4096]。小数：代表相对输出图片分辨率宽度的比率，取值范围为(0,1)	1280
Height	number	动图高度。默认保持原高度。取值为整数或小数时的不同含义如下：整数：代表像素值，单位为 px，取值范围为[1,4096]。小数：代表相对输出图片分辨率高度的比率，取值范围为(0,1)	960
ScaleType	string	缩放方式。取值范围如下： stretch（默认）：拉伸以填满。 crop：缩放并裁剪。 fill：缩放并保留黑边。 fit：缩放并不保留黑边。	crop

object

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

Sprites

array

雪碧图处理列表。

object

雪碧图处理详细信息。

URI

string

保存雪碧图的 OSS 地址。

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

oss://test-bucket/sprites

Format

string

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

jpg
png

jpg

StartTime

number

视频截帧的开始时间，单位为秒（s）。默认值为 0，表示从视频起始时间开始。

0

Interval

number

视频截帧的时间间隔，单位为秒（s）。

1

Number

integer

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

0

ScaleWidth

number

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

整数：像素值，单位为像素（px），取值范围为(1,4096)。
小数：表示相对输出视频分辨率宽度的比率，取值范围为(0,1]。

1280

ScaleHeight

number

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

整数：像素值，单位为像素（px），取值范围为(1,4096)。
小数：表示相对输出视频分辨率高度的比率，取值范围为(0,1]。

960

TileWidth

integer

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

6

TileHeight

integer

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

6

Pad

integer

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

2

Margin

integer

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

2

ScaleType

string

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

stretch（默认）：拉伸以填满。
crop：缩放并裁剪。
fill：缩放并保留黑边。
fit：缩放并不保留黑边。

crop

Mode

string

雪碧图子图截帧模式，取值范围如下：

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

interval

Threshold

integer

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

说明

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

0

Snapshots

array

截帧处理列表。

object

截帧处理详细信息。

URI

string

保存截帧的 OSS 地址。

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

oss://test-bucket/snapshots

Format

string

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

jpg
png

jpg

StartTime

number

视频截帧的开始时间，单位为秒（s）。默认值为 0，表示从视频起始时间开始。

0

Interval

number

视频截帧的时间间隔，单位为秒（s）。

0.5

Number

integer

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

10

Width

number

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

整数：像素值，单位为像素（px），取值范围为[1,4096]。
小数：表示相对输出图片分辨率宽度的比率，取值范围为(0,1)。

1280

Height

number

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

整数：像素值，单位为像素（px），取值范围为[1,4096]。
小数：表示相对输出图片分辨率高度的比率，取值范围为(0,1)。

960

ScaleType

string

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

stretch（默认）：拉伸以填满。
crop：缩放并裁剪。
fill：缩放并保留黑边。
fit：缩放并不保留黑边。

crop

Mode

string

雪碧图子图截帧模式，取值范围如下：

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

interval

Threshold

integer

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

说明

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

0

Animations

array

动图处理列表。

object

动图处理详细信息。

URI

string

保存动图的 OSS 地址。

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

oss://test-bucket/animations

Format

string

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

gif
webp

gif

FrameRate

number

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

25

StartTime

number

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

0

Interval

number

抽帧间隔，单位为秒。

0.5

Number

integer

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

100

Width

number

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

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

1280

Height

number

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

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

960

ScaleType

string

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

stretch（默认）：拉伸以填满。
crop：缩放并裁剪。
fill：缩放并保留黑边。
fit：缩放并不保留黑边。

crop