简介
本文档提供关于媒体信息接口的 API 概览和 SDK 示例代码。
注意
COS Javascript SDK 版本需要大于等于 v1.3.1。
API | 操作名 | 操作描述 |
查询文件信息 | 用于查询媒体文件的信息 |
查询文件信息
功能说明
用于查询媒体文件的信息。
注意
使用此接口前,请确保已打开官网控制台中数据处理下的媒体处理开关,否则会报错
media bucket unbinded, bucket's host is unavailable
。使用示例
function getMediaInfo() {const config = {// 需要替换成您自己的存储桶信息Bucket: 'examplebucket-1250000000', // 存储桶,必须Region: 'COS_REGION', // 存储桶所在地域,必须字段};cos.request({Bucket: config.Bucket, // 存储桶,必须字段Region: config.Region, // 存储桶所在地域,必须字段 如 ap-beijingMethod: 'GET', // 固定值,必须Key: 'test.mp4', // 存储桶内的媒体文件,必须字段Query: {'ci-process': 'videoinfo' // 固定值,必须}}, function (err, data) {console.log(err || data);});}
参数说明
cos.request 方法参数说明:
参数名称 | 参数描述 | 类型 | 是否必填 |
Bucket | 存储桶的名称,命名格式为 BucketName-APPID,此处填写的存储桶名称必须为此格式 | String | 是 |
Region | 存储桶所在地域,枚举值请参见 地域和访问域名 | String | 是 |
Method | 固定值:GET | String | 是 |
Key | 媒体文件在cos的路径 | String | 是 |
Query | 请求参数 | String | 是 |
Query 参数说明:
参数名称 | 参数描述 | 类型 | 是否必填 |
ci-process | 操作类型,固定使用 videoinfo | String | 是 |
回调函数说明
function(err, data) { ... }
参数名称 | 参数描述 | 类型 |
err | Object | |
- statusCode | 请求返回的 HTTP 状态码,例如 200、403、404 等 | Number |
- headers | 请求返回的头部信息 | Object |
data | 请求成功时返回的对象,如果请求发生错误,则为空 | Object |
- statusCode | 请求返回的 HTTP 状态码,例如 200、403、404 等 | Number |
- headers | 请求返回的头部信息 | Object |
- Response | Object |