媒体信息获取接口
更新时间:2022-08-30
查询指定媒体信息
接口描述
用户通过Bucket+BOS Key的URL Encoded的结果获取指定音视频文件的媒体信息。
请求(Request)
-
请求语法:
Http1GET /v{version}/mediainfo?bucket={BOS Bucket}&key={uriComponentEncode(BOS Key)} HTTP/1.1 2accept-encoding: gzip, deflate 3x-bce-date: {utc-date-string} 4host: media.bj.baidubce.com 5accept: */* 6connection: keep-alive 7x-bce-request-id: {bce-request-id} 8content-type: application/json 9authorization: {bce-authorization-string}
- 请求头域:无特殊Header参数
- 请求参数:无
-
请求示例:
Http1GET /v3/mediainfo?bucket=samplebucket&key=sampleforderpath%2Fsampleoutput.mp4 HTTP/1.1 2accept-encoding: gzip, deflate 3x-bce-date: 2015-03-24T13:37:10Z 4host: media.bj.baidubce.com 5accept: */* 6connection: keep-alive 7x-bce-request-id: 3807ce30-5264-45f2-9b52-26b78e24a750 8content-type: application/json 9authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2015-03-24T13:37:10Z/1800/host;x-bce-date/3e1bf9f50ae1fca2d704d61567810dde946fff3ca2e455676455a6f5c8cce596
响应(Reponse)
- 响应头域:无特殊Header参数
- 响应参数:
字段名称 | 字段类型 | 字段描述 |
---|---|---|
bucket | String | 音视频文件所在的BOS的Bucket |
key | String | 音视频文件的BOS的Key |
fileSizeInByte | Number | 音视频文件的大小 |
durationInSecond | Number | 音视频媒体时长 |
container | String | 音视频文件的容器类型 |
etag | String | 文件的版本标识(详见BOS接口公共返回头) |
type | String | 文件类型 |
video | Object | 视频信息集合 |
+ codec | String | 视频文件的编码规格 |
+ heightInPixel | Number | 视频高度 |
+ widthInPixel | Number | 视频宽度 |
+ bitRateInBps | Number | 视频媒体的码率 |
+ frameRate | Number | 视频媒体的帧率 |
+ rotate | Number | 旋转角度(部分视频包含该参数) |
+ dar | String | 视频显示宽高比,如 "16:9" (部分视频包含该参数) |
audio | Object | 音频信息集合 |
+ codec | String | 音频文件的编码规格 |
+ channels | Number | 音频文件的声道信息 |
+ sampleRateInHz | Number | 音频文件的采样率 |
+ bitRateInBps | Number | 音频文件的码率 |
-
响应示例:
Http1HTTP/1.1 200 OK 2Transfer-Encoding: chunked 3x-bce-request-id: 3807ce30-5264-45f2-9b52-26b78e24a750 4Cache-Control: no-cache 5Server: BWS 6Date: Tue, 24 Mar 2015 13:37:10 GMT 7Content-Type: application/json;charset=UTF-8 8 9{ 10 "bucket": "samplebucket", 11 "key": "samplefolderpath/sampleoutput.mp4", 12 "fileSize": 102400, 13 "durationInSecond": 60, 14 "container": "mp4", 15 "eTag": "bf407c4ca0dc4f2f7d581ec94ca36876", 16 "type": "video", 17 "video": { 18 "codec": "h264", 19 "heightInPixel": 1024, 20 "widthInPixel": 768, 21 "bitRateInBps": 2500 22 }, 23 "audio": { 24 "codec": "acc", 25 "channels": 2, 26 "sampleRateInHz": 96000, 27 "bitRateInBps": 1100 28 } 29}