有奖征文:轻量对象存储LighthouseCOS用户实践> HOT

简介

本文档提供关于媒体截图接口的 API 概览和 SDK 示例代码。
API
操作名
操作描述
查询截图
用于查询媒体文件在某个时间的截图

查询截图

功能说明

用于查询媒体文件在某个时间的截图。
注意
COS Go SDK 版本需要大于等于 v0.7.32。

方法原型

func (s *CIService) GetSnapshot(ctx context.Context, name string, opt *GetSnapshotOptions, id ...string) (*Response, error)

请求示例

opt := &cos.GetSnapshotOptions{
Time: 1,
}
resp, err := c.CI.GetSnapshot(context.Background(), "test.mp4", opt)
if err != nil {
// ERROR
}

fd, err := os.OpenFile("test.jpg", os.O_WRONLY|os.O_CREATE|os.O_TRUNC, 0660)
if err != nil {
// ERROR
}
_, err = io.Copy(fd, resp.Body)
fd.Close()

参数说明

type GetSnapshotOptions struct {
Time float32
Height int
Width int
Format string
Rotate string
Mode string
}
参数名称
参数描述
是否必填
类型
name
对象键(Key)是对象在存储桶中的唯一标识。例如,在对象的访问域名examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com/doc/pic.jpg中,对象键为 doc/pic.jpg
name
opt
截图参数
struct
id
针对版本控制的对象 VersionId
String
Time
截图的时间点,单位为秒
float
Width
截图的宽。默认为0
Int
Height
截图的高。默认为0 当 width 和 height 都为0时,表示使用视频的宽高;如果单个为0,则以另外一个值按视频宽高比例自动适应
Int
Format
截图的格式,支持 jpg 和 png,默认 jpg
String
Rotate
图片旋转方式 auto:按视频旋转信息进行自动旋转off:不旋转默认值为 auto
String
Mode
截帧方式 keyframe:截取指定时间点之前的最近的一个关键帧exactframe:截取指定时间点的帧默认值为 exactframe
String

返回结果说明

参数名称
参数描述
是否必填
类型
Response
http响应
Struct
Response.Header
http响应头部
Struct
Response.Body
http响应数据
Struct