什么是视频截雪碧图_对象存储(OSS)-阿里云帮助中心

视频截雪碧图（CSS Sprite或CSS Sprites）的场景主要应用于网站性能优化和前端开发中。雪碧图通常是指将多个小图标或图像拼接在一起形成一张大图，通过CSS背景定位技术实现单次HTTP请求加载多个图片资源，从而减少网页加载时间和提升用户体验。您可以通过视频截雪碧图功能，提取视频帧并按一定规则拼接为雪碧图。本文介绍视频截雪碧图功能参数及示例。

注意事项

视频截雪碧图仅支持异步处理（x-oss-async-process处理方式）。
视频截雪碧图可能由于视频时间戳或码流的损坏而失败或数量不正确。
使用视频截雪碧图前，需要先绑定IMM Project。关于控制台和API如何绑定，请参见快速入门和 AttachOSSBucket 。
不支持匿名访问。
必须拥有IMM处理所需的相关权限。更多信息，请参见权限。

参数说明

操作名称： video/sprite

具体参数如下表所示。

参数	类型	是否必须	描述
ss	int	否	视频截雪碧图的起始时间，单位为毫秒。取值： 0（默认值）：从起始位置开始。大于0：从第 ss 毫秒开始。
f	string	是	雪碧图输出格式，取值： jpg png
num	int	否	雪碧图子图的抽帧数量，默认为不限制数量（抽帧到视频结束）。
inter	int	否	雪碧图子图的抽帧间隔，单位为毫秒，默认抽取所有视频帧。
sw	int	否	雪碧图子图的宽度，单位为px，取值范围为[32,4096]，默认与源视频宽度相同。
sh	int	否	雪碧图子图的高度，单位为px，取值范围为[32,4096]，默认与源视频高度相同。
psw	int	否	雪碧图子图宽度与原始视频宽度的百分比，取值范围为(0,200]，默认值为100。
psh	int	否	雪碧图子图高度与原始视频高度的百分比，取值范围为(0,200]，默认值为100。
scaletype	string	否	缩放方式。取值： crop：缩放并裁剪。 stretch（默认值）：拉伸以填满。 fill：缩放并保留黑边。 fit：缩放并不保留黑边，等比缩放。
tw	int	否	雪碧图每行包含的子图数量，默认值为6，取值范围为[1, 100]。
th	int	否	雪碧图每列包含的子图数量，默认值为6，取值范围为[1, 100]。
pad	int	否	雪碧图子图间的间隔，单位px，默认值为2，取值范围为[0, 100]。
margin	int	否	雪碧图边缘间隔，单位px，默认值为2，取值范围为[0, 100]。

// 对文件example.mkv进行视频截雪碧图。
POST /exmaple.mkv?x-oss-async-process HTTP/1.1
Host: video-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS qn6qrrqxo2oawuk53otf****:UNQDb7GapEgJkcde6OhZ9J****
x-oss-async-process=video/sprite,f_jpg,sw_100,sh_100,inter_10000,tw_10,th_10,pad_0,margin_0|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LXtpbmRleH0ue2F1dG9leHR9Cg/notify,topic_QXVkaW9Db252ZXJ0

// 对文件example.mkv进行视频截雪碧图。
POST /exmaple.mkv?x-oss-async-process HTTP/1.1
Host: video-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS qn6qrrqxo2oawuk53otf****:UNQDb7GapEgJkcde6OhZ9J****
x-oss-async-process=video/sprite,ss_3000,f_png,psw_5,psh_5,num_100,tw_20,th_5|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQo/notify,topic_QXVkaW9Db252ZXJ0

注意事项

参数说明

使用REST API

以每10秒截1帧的形式对视频进行截雪碧图

截帧信息

处理示例

从视频的第3秒连续抽帧100帧生成单张雪碧图

截帧信息

处理示例

使用SDK