控制台指南

最佳实践

开发者指南

API 文档

SDK 文档

诚邀爱技术、爱分享的你,成为文档内容共建者> HOT

简介

本文档提供关于媒体截图接口的 API 概览和 SDK 示例代码。

API 操作名 操作描述
GetSnapshot 查询截图 用于查询媒体文件在某个时间的截图

查询截图

功能说明

用于查询媒体文件在某个时间的截图。

注意:

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
目录