通过视频截帧功能,用户可以在GetObject请求中携带视频截帧处理参数对视频文件进行处理,服务默认会保存视频截帧的图片,图片会保存在视频所在 bucket 的 snapshot 目录下面。
本文介绍视频截帧操作涉及的参数说明及使用示例。
适用区域
本功能目前仅部分资源池支持,具体可参考:资源池与区域节点。
如需使用,可联系客户经理或提交工单申请。
注意事项
仅支持对视频编码格式为H264和H265的视频文件进行视频截帧。
媒体存储默认会保存视频截帧的图片,图片会保存在视频所在 bucket 的 snapshot 目录下面。
参数说明
操作分类:video
操作名称:snapshot
参数 | 描述 | 取值范围 |
---|---|---|
t | 指定截图时间。 | [0,视频时长] 单位:ms |
w | 指定截图宽度,如果指定为0,则自动计算。 | [0,视频宽度] 单位:像素(px) |
h | 指定截图高度,如果指定为0,则自动计算; 如果w和h都为0,则输出为原视频宽高。 | [0,视频高度] 单位:像素(px) |
m | 指定截图模式,不指定则为默认模式,根据时间精确截图。如果指定为fast,则截取该时间点之前的最近的一个关键帧。 | 枚举值:fast |
f | 指定输出图片的格式。 | 枚举值:jpg、png |
使用示例
使用fast模式截取视频7s处的内容,输出为JPG格式的图片,宽度为800,高度为600。
处理后的URL为:<原视频URL>?x-amz-process=video/snapshot,t_7000,f_jpg,w_800,h_600,m_fast
使用精确时间模式截取视频50s处的内容,输出为JPG格式的图片,宽度为800,高度为600。
处理后的URL为:<原视频URL>?x-amz-process=video/snapshot,t_50000,f_jpg,w_800,h_600