GenerateMediainfo

最近更新时间:2019-11-04 16:49:07

功能描述

提交媒体元信息接口,媒体处理服务会对输入文件进行媒体信息分析;用户可通过该接口查询输入文件的媒体信息。

请求

请求示例

POST /mediainfo HTTP/1.1
Host: <BucketName-APPID>.ci.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Content-Length: <length>
Content-type: application/xml

<body>
说明:

Authorization: Auth String(详情请参阅 请求签名 章节)。

请求头

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

请求体

该 API 接口请求的请求体具体节点内容为:

<Request>
  <Input>
    <Object></Object>
  </Input>
</Request>

具体的数据内容如下:

节点名称(关键字) 父节点 描述 类型 是否必选
Request 保存 GET Media info 请求的容器 Container

Container 节点 Request 的内容:

节点名称(关键字) 父节点 描述 类型 是否必选
Input Request 媒体文件的位置信息 Container

Container 节点 Input 的内容:

节点名称(关键字) 父节点 描述 类型 是否必选
Object Request.Input 媒体文件的名称 String

响应

响应头

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

响应体

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

<Response>
  <MediaInfo>
    <Stream>
      <Video>
        <Index></Index>
        <CodecName></CodecName>
        <CodecLongName></CodecLongName>
        <CodecTimeBase></CodecTimeBase>
        <CodecTagString></CodecTagString>
        <CodecTag></CodecTag>
        <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 媒体 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 媒体 Int
Size Response.MediaInfo.Format 媒体 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
Profile Response.MediaInfo.Stream.Video 媒体 String
Height Response.MediaInfo.Stream.Video 媒体 Int
HasBFrame Response.MediaInfo.Stream.Video 媒体 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 媒体 Int
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 媒体 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 媒体 Float
Language Response.MediaInfo.Stream.Audio 媒体 String

Container 节点 Subtitle 的内容:

节点名称(关键字) 父节点 描述 类型
Index Response.MediaInfo.Stream.Subtitle 媒体 Int
Language Response.MediaInfo.Stream.Subtitle 媒体 String

错误码

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

实际案例

请求

POST /mediainfo HTTP/1.1
Host: bucket-1250000000.ci.ap-beijing.myqcloud.com
Date: Fri, 10 Mar 2016 09:45:46 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKIDWtTCBYjM5OwLB9CAwA1Qb2ThTSUjfGFO&q-sign-time=1484213027;32557109027&q-key-time=1484213027;32557109027&q-header-list=host&q-url-param-list=acl&q-signature=dcc1eb2022b79cb2a780bf062d3a40e120b40652
Content-Length: 352
Content-Type: application/xml

<Request>
  <Input>
    <Object>/video-for-test.mp4</Object>
  </Input>
</Request>

响应

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-ci
x-ci-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>
                                <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>