对象存储

文档中心对象存储 API 文档数据处理接口媒体处理同步媒体处理媒体信息接口获取媒体文件信息

获取媒体文件信息

最近更新时间：2022-07-07 16:15:41

前往 GitHub 编辑 我的收藏

本页目录：

功能描述

GetMediainfo 接口用于获取媒体文件的信息。

推荐使用 API Explorer

点击调试

API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

请求

请求示例

GET /for-test.mp4?ci-process=videoinfo HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Content-Length: <length>

说明：

Authorization: Auth String（详情请参见请求签名文档）。

通过子账号使用时，需要授予相关的权限，详情请参见授权粒度详情文档。

请求头

此接口仅使用公共请求头部，详情请参见公共请求头部文档。

请求参数

参数说明如下：

节点名称（关键字）	父节点	描述	类型	是否必选
ci-process	无	操作类型，固定使用 videoinfo	String	是

请求体

该请求无请求体。

响应

响应头

此接口仅返回公共响应头部，详情请参见公共响应头部文档。

响应体

该响应体返回为 application/xml 数据，包含完整节点数据的内容展示如下：

<Response>
      <MediaInfo>
         <Stream>
            <Video>
                <Index></Index>
                <CodecName></CodecName>
                <CodecLongName></CodecLongName>
                <CodecTimeBase></CodecTimeBase>
                <CodecTagString></CodecTagString>
                <CodecTag></CodecTag>
                <ColorPrimaries></ColorPrimaries>
                <ColorRange></ColorRange>
                <ColorTransfer></ColorTransfer>
                <Profile></Profile>
                <Width></Width>
                <Height></Height>
                <HasBFrame></HasBFrame>
                <RefFrames></RefFrames>
                <Sar></Sar>
                <Dar></Dar>
                <PixFormat></PixFormat>
                <FieldOrder></FieldOrder>
                <Level></Level>
                <Fps></Fps>
                <AvgFps></AvgFps>
                <Timebase></Timebase>
                <StartTime></StartTime>
                <Duration></Duration>
                <Bitrate></Bitrate>
                <NumFrames></NumFrames>
                <Language></Language>
            </Video>
            <Audio>
                <Index></Index>
                <CodecName></CodecName>
                <CodecLongName></CodecLongName>
                <CodecTimeBase></CodecTimeBase>
                <CodecTagString></CodecTagString>
                <CodecTag></CodecTag>
                <SampleFmt></SampleFmt>
                <SampleRate></SampleRate>
                <Channel></Channel>
                <ChannelLayout></ChannelLayout>
                <Timebase></Timebase>
                <StartTime></StartTime>
                <Duration></Duration>
                <Bitrate></Bitrate>
                <Language></Language>
            </Audio>
            <Subtitle>
                <Index></Index>
                <Language></Language>
            </Subtitle>
         </Stream>
         <Format>
            <NumStream></NumStream>
            <NumProgram></NumProgram>
            <FormatName></FormatName>
            <FormatLongName></FormatLongName>
            <StartTime></StartTime>
            <Duration></Duration>
            <Bitrate></Bitrate>
            <Size></Size>
         </Format>
      </MediaInfo>
</Response>

具体的数据内容如下：

节点名称（关键字）	父节点	描述	类型
Response	无	保存结果的容器	Container

Container 节点 Response 的内容：

节点名称（关键字）	父节点	描述	类型
MediaInfo	Response	媒体的详细信息	Container

Container 节点 MediaInfo 的内容：

节点名称（关键字）	父节点	描述	类型
Stream	Response.MediaInfo	流信息	Container
Format	Response.MediaInfo	格式信息	Container

Container 节点 Stream 的内容：

节点名称（关键字）	父节点	描述	类型
Video	Response.MediaInfo. Stream	视频信息	Container
Audio	Response.MediaInfo. Stream	音频信息	Container
Subtitle	Response.MediaInfo. Stream	字幕信息	Container

Container 节点 Format 的内容（查询视频信息时，可能部分字段未返回）：

节点名称（关键字）	父节点	描述	类型
NumStream	Response.MediaInfo. Format	Stream（包含 Video、Audio、Subtitle）的数量	Int
NumProgram	Response.MediaInfo. Format	节目的数量	Int
FormatName	Response.MediaInfo. Format	容器格式名字	String
FormatLongName	Response. MediaInfo.Format	容器格式的详细名字	String
StartTime	Response.MediaInfo. Format	起始时间，单位为秒	Float
Duration	Response.MediaInfo. Format	时长，单位为秒	Float
Bitrate	Response.MediaInfo. Format	比特率，单位为 kbps	Int
Size	Response.MediaInfo. Format	大小，单位为 Byte	Int

Container 节点 Video 的内容（查询视频信息时，可能部分字段未返回）：

节点名称（关键字）	父节点	描述	类型
Index	Response.MediaInfo. Stream.Video	该流的编号	Int
CodecName	Response.MediaInfo. Stream.Video	编解码格式名字	String
CodecLongName	Response.MediaInfo. Stream.Video	编解码格式的详细名字	String
CodecTimeBase	Response.MediaInfo. Stream.Video	编码时基	String
CodecTagString	Response.MediaInfo. Stream.Video	编码标签名	String
CodecTag	Response.MediaInfo. Stream.Video	编码标签	String
ColorPrimaries	Response.MediaInfo. Stream.Video	色原	String
ColorRange	Response.MediaInfo. Stream.Video	色彩范围	String
ColorTransfer	Response.MediaInfo. Stream.Video	色彩通道	String
Profile	Response.MediaInfo. Stream.Video	视频编码档位	String
Height	Response.MediaInfo. Stream.Video	视频高，单位 px	Int
Width	Response.MediaInfo. Stream.Video	视频宽，单位 px	Int
HasBFrame	Response.MediaInfo. Stream.Video	是否有B帧。1表示有，0表示无	Int
RefFrames	Response.MediaInfo. Stream.Video	视频编码的参考帧个数	Int
Sar	Response.MediaInfo. Stream.Video	采样宽高比	String
Dar	Response.MediaInfo. Stream.Video	显示宽高比	String
PixFormat	Response.MediaInfo. Stream.Video	像素格式	String
FieldOrder	Response.MediaInfo. Stream.Video	场的顺序	String
Level	Response.MediaInfo. Stream.Video	视频编码等级	Int
Fps	Response.MediaInfo. Stream.Video	视频帧率	Float
AvgFps	Response.MediaInfo. Stream.Video	平均帧率	String
Timebase	Response.MediaInfo. Stream.Video	时基	String
StartTime	Response.MediaInfo. Stream.Video	视频开始时间，单位为秒	Float
Duration	Response.MediaInfo. Stream.Video	视频时长，单位为秒	Float
Bitrate	Response.MediaInfo. Stream.Video	比特率，单位为 kbps	Float
NumFrames	Response.MediaInfo. Stream.Video	总帧数	Int
Language	Response.MediaInfo. Stream.Video	语言	String

Container 节点 Audio 的内容（查询视频信息时，可能部分字段未返回）：

节点名称（关键字）	父节点	描述	类型
Index	Response.MediaInfo. Stream.Audio	该流的编号	Int
CodecName	Response.MediaInfo. Stream.Audio	编解码格式名字	String
CodecLongName	Response.MediaInfo. Stream.Audio	编解码格式的详细名字	String
CodecTimeBase	Response.MediaInfo. Stream.Audio	编码时基	String
CodecTagString	Response.MediaInfo. Stream.Audio	编码标签名	String
CodecTag	Response.MediaInfo. Stream.Audio	编码标签	String
SampleFmt	Response.MediaInfo. Stream.Audio	采样格式	String
SampleRate	Response.MediaInfo. Stream.Audio	采样率	Int
Channel	Response.MediaInfo. Stream.Audio	通道数量	Int
ChannelLayout	Response.MediaInfo. Stream.Audio	通道格式	String
Timebase	Response.MediaInfo. Stream.Audio	时基	String
StartTime	Response.MediaInfo. Stream.Audio	音频开始时间，单位秒	Float
Duration	Response.MediaInfo. Stream.Audio	音频时长，单位秒	Float
Bitrate	Response.MediaInfo. Stream.Audio	比特率，单位 kbps	Float
Language	Response.MediaInfo. Stream.Audio	语言	String

Container 节点 Subtitle 的内容：

节点名称（关键字）	父节点	描述	类型
Index	Response.MediaInfo. Stream.Subtitle	该流的编号	Int
Language	Response.MediaInfo. Stream.Subtitle	语言，und 表示无查询结果	String

错误码

该请求操作无特殊错误信息，常见的错误信息请参见错误码文档。

实际案例

请求

GET /for-test.mp4?ci-process=videoinfo HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Fri, 10 Mar 2016 09:45:46 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKIDWtTCBYjM5OwLB9CAwA1Qb2ThTSUjfG****-sign-time=1484213027;32557109027&q-key-time=1484213027;32557109027&q-header-list=host&q-url-param-list=acl&q-signature=dcc1eb2022b79cb2a780bf062d3a40e120b4****
Content-Length: 0

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 666
Connection: keep-alive
Date: Fri, 10 Mar 2016 09:45:46 GMT
Server: tencent-cos
x-cos-request-id: NTg3NzRiMjVfYmRjMzVfMTViMl82ZGZmNw==



<Response>
        <MediaInfo>
                <Format>
                        <Bitrate>1014.950000</Bitrate>
                        <Duration>10.125000</Duration>
                        <FormatLongName>QuickTime / MOV</FormatLongName>
                        <FormatName>mov,mp4,m4a,3gp,3g2,mj2</FormatName>
                        <NumProgram>0</NumProgram>
                        <NumStream>2</NumStream>
                        <Size>1284547</Size>
                        <StartTime>0.000000</StartTime>
                </Format>
                <Stream>
                        <Audio>
                                <Bitrate>70.451000</Bitrate>
                                <Channel>1</Channel>
                                <ChannelLayout>mono</ChannelLayout>
                                <CodecLongName>AAC (Advanced Audio Coding)</CodecLongName>
                                <CodecName>aac</CodecName>
                                <CodecTag>0x6134706d</CodecTag>
                                <CodecTagString>mp4a</CodecTagString>
                                <CodecTimeBase>1/44100</CodecTimeBase>
                                <Duration>0.440294</Duration>
                                <Index>1</Index>
                                <Language>und</Language>
                                <SampleFmt>fltp</SampleFmt>
                                <SampleRate>44100</SampleRate>
                                <StartTime>0.000000</StartTime>
                                <Timebase>1/44100</Timebase>
                        </Audio>
                        <Subtitle/>
                        <Video>
                                <AvgFps>24/1</AvgFps>
                                <Bitrate>938.164000</Bitrate>
                                <CodecLongName>H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10</CodecLongName>
                                <CodecName>h264</CodecName>
                                <CodecTag>0x31637661</CodecTag>
                                <CodecTagString>avc1</CodecTagString>
                                <CodecTimeBase>1/12288</CodecTimeBase>
                                <ColorPrimaries>unknown</ColorPrimaries>
                                <ColorRange>unknown</ColorRange>
                                <ColorTransfer>unknown</ColorTransfer>
                                <Dar>40:53</Dar>
                                <Duration>0.124416</Duration>
                                <Fps>24.500000</Fps>
                                <HasBFrame>2</HasBFrame>
                                <Height>1280</Height>
                                <Index>0</Index>
                                <Language>und</Language>
                                <Level>32</Level>
                                <NumFrames>243</NumFrames>
                                <PixFormat>yuv420p</PixFormat>
                                <Profile>High</Profile>
                                <RefFrames>1</RefFrames>
                                <Sar>25600:25599</Sar>
                                <StartTime>0.000000</StartTime>
                                <Timebase>1/12288</Timebase>
                                <Width>966</Width>
                        </Video>
                </Stream>
        </MediaInfo>
</Response>

上一篇: 获取媒体文件截图（万象域名）下一篇: GetPrivateM3U8

动态与公告

产品简介

购买指南

快速入门

控制台指南

工具指南

最佳实践

视频教程专区

开发者指南

第三方教程

数据湖存储

数据处理 Demo 体验

故障处理

API 文档

SDK 文档

常见问题

服务等级协议

附录

联系我们

词汇表