查询预览图结果
更新时间： 2025/01/22 15:03:36
调用本接口可查询视频生成的预览快照图（雪碧图，Sprite Images）的信息，方便客户端在播放视频的同时拖动进度条预览其他时间区间的视频截图。
请求信息
请求频率
请参考 接口概述 频率说明章节。
请求 URL
POST http://vcloud.163.com/app/vod/previewSnapshot/get
请求头参数
请参考 接口概述 公共参数章节。
请求体参数
| 参数 | 类型 | 是否必需 | 说明 |
|---|---|---|---|
| vid | Long | 是 | 点播视频的 ID。 |
响应信息
响应体参数
| 参数 | 类型 | 说明 |
|---|---|---|
| - ret | Object | 返回的具体业务数据。 |
| - previewsInfo | Object | 预览图布局信息。 |
| columns | Integer | 列数。 |
| interval | Integer | 截图间隔，单位为秒。 |
| rows | Integer | 行数。 |
| width | Integer | 预览图宽。 |
| height | Integer | 预览图高。 |
| - previewList | List<JSON> | 预览图列表。 |
| imageId | Integer | 预览图 ID。 |
| objectKey | String | 预览图的文件名称。 |
| beginTime | Integer | 预览图位于视频进度的具体时间点。 |
| url | String | 预览图存储的地址。 |
| code | Integer | 返回的 HTTP 状态码，请参考 状态码。 |
| requestId | String | 请求 ID。 |
响应体示例
JSON{
"ret": {
"previewsInfo": {
"columns": 10,
"width": 1200,
"interval": 1,
"rows": 6,
"height": 408
},
"previewList": [
{
"imageId": 2872136,
"objectKey": "c2530228-7448-4015-878b-****-8.jpg",
"beginTime": 420000,
"url": "http://jdvodxzv*****.nosdn.127.net/c2530228-7448-4015-878b-****-8.jpg"
},
{
"imageId": 2872134,
"objectKey": "c2530228-7448-4015-878b-****-4.jpg",
"beginTime": 180000,
"url": "http://jdvodxzv*****.nosdn.127.net/c2530228-7448-4015-878b-****-4.jpg"
},
{
"imageId": 2872133,
"objectKey": "c2530228-7448-4015-878b-****-2.jpg",
"beginTime": 60000,
"url": "http://jdvodxzv*****.nosdn.127.net/c2530228-7448-4015-878b-****-2.jpg"
},
{
"imageId": 2872135,
"objectKey": "c2530228-7448-4015-878b-****-6.jpg",
"beginTime": 300000,
"url": "http://jdvodxzv*****.nosdn.127.net/c2530228-7448-4015-878b-****-6.jpg"
},
{
"imageId": 2873013,
"objectKey": "c2530228-7448-4015-878b-****-5.jpg",
"beginTime": 240000,
"url": "http://jdvodxzv*****.nosdn.127.net/c2530228-7448-4015-878b-****-5.jpg"
},
{
"imageId": 2873011,
"objectKey": "c2530228-7448-4015-878b-****-1.jpg",
"beginTime": 0,
"url": "http://jdvodxzv*****.nosdn.127.net/c2530228-7448-4015-878b-****-1.jpg"
},
{
"imageId": 2873014,
"objectKey": "c2530228-7448-4015-878b-****-7.jpg",
"beginTime": 360000,
"url": "http://jdvodxzv*****.nosdn.127.net/c2530228-7448-4015-878b-****-7.jpg"
},
{
"imageId": 2873012,
"objectKey": "c2530228-7448-4015-878b-****-3.jpg",
"beginTime": 120000,
"url": "http://jdvodxzv*****.nosdn.127.net/c2530228-7448-4015-878b-****-3.jpg"
},
{
"imageId": 2873015,
"objectKey": "c2530228-7448-4015-878b-****-9.jpg",
"beginTime": 480000,
"url": "http://jdvodxzv*****.nosdn.127.net/c2530228-7448-4015-878b-****-9.jpg"
}
]
},
"code": 200,
"requestId": "voda0c973e74af047a2a****"
}
此文档是否对你有帮助？
