功能描述
GenerateSnapshot 接口用于获取媒体文件某个时间的截图,输出的截图统一为 jpeg 格式。
请求
请求示例
POST /snapshot HTTP/1.1Host: <BucketName-APPID>.ci.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>Content-Length: <length>Content-type: application/xml<body>
请求头
请求体
该 API 接口请求的具体节点内容为:
<Request><Input><Object>input/test.mp4</Object></Input><Output><Bucket>test-1234567890</Bucket><Region>ap-chongqing</Region><Object>snapshot.jpg</Object></Output><Time>5</Time></Request>
具体的数据内容如下:
节点名称(关键字) | 父节点 | 描述 | 类型 | 是否必选 |
Request | 无 | 保存 Generate Snapshot 请求的容器 | Container | 是 |
Container 节点 Request 的内容:
节点名称(关键字) | 父节点 | 描述 | 类型 | 是否必选 |
Input | Request | 媒体文件的位置信息 | Container | 是 |
Time | Request | 截取哪个时间点的内容,单位为秒。Time 大于源视频时长时,会导致截图失败 | Float | 是 |
Output | Request | 截图保存的位置信息 | Container | 是 |
Width | Request | 截图的宽。默认为0 | Int | 否 |
Height | Request | 截图的高。默认为0 | Int | 否 |
Format | Request | 截图的格式,支持 jpg 和 png,默认 jpg | String | 否 |
Mode | Request | 截帧方式: keyframe:截取指定时间点之前的最近的一个关键帧 exactframe:截取指定时间点的帧 默认值为 exactframe | String | 否 |
Rotate | Request | 图片旋转方式: auto:按视频旋转信息进行自动旋转 off:不旋转 默认值为 auto | String | 否 |
说明:
Width 和 Height 都为0时,表示使用视频的宽高。如果单个为0,则以另外一个值按视频宽高比例自动适应。
Container 节点 Input 的内容:
节点名称(关键字) | 父节点 | 描述 | 类型 | 是否必选 |
Object | Request.Input | 文件的路径 | String | 是 |
Container 节点 Output 的内容:
节点名称(关键字) | 父节点 | 描述 | 类型 | 是否必选 |
Region | Request.Output | 存储桶所在的地域 | String | 是 |
Bucket | Request.Output | 文件所属的 COS 存储桶 | String | 是 |
Object | Request.Output | 文件的路径 | String | 是 |
响应
响应头
响应体
该响应体返回为 application/xml 数据,包含完整节点数据的内容展示如下:
<Response><Output><Bucket>test-1234567890</Bucket><Object>1847246test.snapshot.jpg</Object><Region>ap-chongqing</Region></Output></Response>
具体的数据内容如下:
节点名称(关键字) | 父节点 | 描述 | 类型 |
Response | 无 | 保存结果的容器 | Container |
Container 节点 Response 的内容:
节点名称(关键字) | 父节点 | 描述 | 类型 |
Output | Request | 截图保存的位置信息,同 Request.Output | Container |
错误码
实际案例
请求
POST /snapshot HTTP/1.1Host: test-1234567890.ci.ap-chongqing.myqcloud.comAuthorization: q-sign-algorithm=sha1&q-ak=AKIDWtTCBYjM5OwLB9CAwA1Qb2ThTSUj****&q-sign-time=1484213027;32557109027&q-key-time=1484213027;32557109027&q-header-list=host&q-url-param-list=acl&q-signature=dcc1eb2022b79cb2a780bf062d3a40e120b4****Content-Length: 552Content-Type: application/xml<Request><Input><Object>input/test.mp4</Object></Input><Output><Bucket>test-1234567890</Bucket><Region>ap-chongqing</Region><Object>snapshot.jpg</Object></Output><Time>5</Time></Request>
响应
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 266Connection: keep-aliveDate: Fri, 10 Mar 2016 09:45:46 GMTServer: tencent-cix-ci-request-id: NTg3NzRiMjVfYmRjMzVfMTViMl82ZGZm****<Response><Output><Bucket>test-1234567890</Bucket><Object>1847246test.snapshot.jpg</Object><Region>ap-chongqing</Region></Output></Response>