调用GetMediaMeta获取视频的多媒体信息,包括媒体格式信息和媒体流信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String GetMediaMeta

操作接口名称,固定取值为GetMediaMeta。

MediaUri String oss://imm-test/testcases/video.mp4

视频的OSS URI。

OSS地址规则为oss://buc的ket/object,其中bucket为和当前项目处于同一区域的OSS Bucket名称,object为文件路径。

Project String immvideotest

项目名称。

RegionId String cn-hangzhou

项目所在地域的ID。

地域Endpoint格式为imm.RegionId.aliyuncs.com,例如当RegionId为cn-hangzhou时,地域Endpoint为imm.cn-hangzhou.aliyuncs.com。

返回数据

名称 类型 示例值 描述
MediaMeta Struct

多媒体信息。

MediaFormat Struct

媒体格式信息。

Address Struct

视频地理位置检测结果。

只有视频中包含地理位置信息时,检测结果才有值。

AddressLine String 中国浙江省杭州市西湖区转塘街道石龙山西路

视频地理位置的完整地址。

City String 杭州市

视频地理位置所在城市(或同级)。

Country String 中国

视频地理位置所在国家或地区。

District String 西湖区

视频地理位置所在区(或同级)。

Province String 浙江省

视频地理位置所在省(或同级)。

Township String 转塘街道

视频地理位置所在街道(或同级)。

Bitrate String 13164131

视频的码率,单位为比特每秒(bit/s)。

CreationTime String 2020-10-25T09:16:09.000000Z

视频的创建时间。

Duration String 15.263000

视频的总时长。

FormatLongName String QuickTime / MOV

格式名称的全称。

FormatName String mov,mp4,m4a,3gp,3g2,mj2

格式名称。

Location String 30.134390,120.074997

视频地理位置,从EXIF信息中获取,格式为lat,long,以英文逗号(,)分隔的浮点数。

如果视频EXIF信息无此信息,则返回结果中无此参数。

NumberPrograms Integer 2

当前版本不支持此参数。

场景数量。

NumberStreams Integer 2

媒体流数量。

Size String 25115517

视频文件大小,单位为字节。

StartTime String 0.000000

视频的首帧时间。

Tag Struct

标签信息。

Album String unable

当前版本不支持此参数。

专辑。

AlbumArtist String unable

当前版本不支持此参数。

演唱者。

Artist String unable

当前版本不支持此参数。

艺术家。

Composer String unable

当前版本不支持此参数。

作曲家。

CreationTime String 2020-10-25T09:16:09.000000Z

标签创建时间。

Language String unable

当前版本不支持此参数。

语言。

Performer String unable

当前版本不支持此参数。

演奏者。

Title String unable

当前版本不支持此参数。

名称。

MediaStreams Struct

媒体流信息。

AudioStreams Array of AudioStream

音频流信息。

Bitrate String 64003

码率,单位为比特每秒(bit/s)。

ChannelLayout String mono

声道设计。

Channels Integer 1

声道数量。

CodecLongName String AAC (Advanced Audio Coding)

编码器名称的全称。

CodecName String aac

编码器名称。

CodecTag String 0x6134706d

编码器标识。

CodecTagString String mp4a

编码器标识描述信息。

CodecTimeBase String 1/44100

编码器每帧时长。

Duration String 15.256803

音频总时长。

Frames String 656

帧数。

Index Integer 1

音频流索引号。

Language String eng

音频语言。

SampleFormat String fltp

采样格式。

SampleRate String 44100

采样率。

StartTime String 0.000000

首帧时间。

TimeBase String 1/44100

每帧时长。

SubtitleStreams Array of SubtitleStream

字幕流信息。

Index Integer 2

字幕流索引号。

Language String eng

字幕语言。

VideoStreams Array of VideoStream

视频流信息。

AverageFrameRate String 41580000/1373627

平均帧率。

Bitrate String 13091201

码率,单位为比特每秒(bit/s)。

CodecLongName String H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10

编码器名称的全称。

CodecName String h264

编码器名称。

CodecTag String 0x31637661

编码器标识。

CodecTagString String avc1

编码器标识描述信息。

CodecTimeBase String 1373627/83160000

编码器每帧时长。

DisplayAspectRatio String 9:16

视频画面显示时的宽高比例。

Duration String 15.262522

视频总时长,单位为秒。

FrameRrate String 90000/1

真实基础帧率。

Frames String 462

帧数。

HasBFrames Integer 2

记录帧缓存大小。

Height Integer 1920

视频画面高度。

Index Integer 0

视频流索引号。

Language String eng

视频中使用的语言。

Level Integer 40

级别,可用于限制整体参数比率。

PixelFormat String yuv420p

视频的存储格式。

Profile String Baseline

Profile配置。

Rotate String 90

视频画面旋转角度。

SampleAspectRatio String 1:1

采样率。

StartTime String 0.000000

首帧时间。

TimeBase String 1/90000

每帧时长。

Width Integer 1080

视频画面宽度。

MediaUri String oss://imm-test/testcases/video.mp4

视频的OSS URI。

RequestId String 2213B1A9-EB3D-4666-84E0-24980BCC4649

当次请求的Request ID。

示例

请求示例

http(s)://[Endpoint]/?Action=GetMediaMeta
&MediaUri=oss://imm-test/testcases/video.mp4
&Project=immvideotest
&<公共请求参数>

正常返回示例

XML格式

<MediaUri>oss://imm-test/testcases/video.mp4</MediaUri>
<RequestId>2213B1A9-EB3D-4666-84E0-24980BCC4649</RequestId>
<MediaMeta>
    <MediaFormat>
        <Address>
            <Township>转塘街道</Township>
            <AddressLine>中国浙江省杭州市西湖区转塘街道石龙山西路</AddressLine>
            <Country>中国</Country>
            <City>杭州市</City>
            <District>西湖区</District>
            <Province>浙江省</Province>
        </Address>
        <Size>25115517</Size>
        <NumberStreams>2</NumberStreams>
        <FormatLongName>QuickTime / MOV</FormatLongName>
        <CreationTime>2020-10-25T09:16:09.000000Z</CreationTime>
        <StartTime>0</StartTime>
        <FormatName>mov,mp4,m4a,3gp,3g2,mj2</FormatName>
        <Duration>15.263</Duration>
        <Bitrate>13164131</Bitrate>
        <Location>30.134390,120.074997</Location>
        <NumberPrograms/>
    </MediaFormat>
    <MediaStreams>
        <VideoStreams>
            <CodecTag>0x31637661</CodecTag>
            <Frames>462</Frames>
            <CodecTimeBase>1373627/83160000</CodecTimeBase>
            <Rotate>90</Rotate>
            <SampleAspectRatio>1:1</SampleAspectRatio>
            <StartTime>0</StartTime>
            <Duration>15.262522</Duration>
            <Index>0</Index>
            <Bitrate>13091201</Bitrate>
            <CodecName>h264</CodecName>
            <Profile>Baseline</Profile>
            <DisplayAspectRatio>9:16</DisplayAspectRatio>
            <HasBFrames>2</HasBFrames>
            <CodecTagString>avc1</CodecTagString>
            <AverageFrameRate>41580000/1373627</AverageFrameRate>
            <Language>eng</Language>
            <CodecLongName>H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10</CodecLongName>
            <Level>40</Level>
            <PixelFormat>yuv420p</PixelFormat>
            <Height>1920</Height>
            <FrameRrate>90000/1</FrameRrate>
            <Width>1080</Width>
            <TimeBase>1/90000</TimeBase>
        </VideoStreams>
        <SubtitleStreams>
            <Language>eng</Language>
            <Index>2</Index>
        </SubtitleStreams>
        <AudioStreams>
            <CodecTag>0x31637661</CodecTag>
            <Frames>656</Frames>
            <CodecTimeBase>1/44100</CodecTimeBase>
            <ChannelLayout>mono</ChannelLayout>
            <StartTime>0</StartTime>
            <Duration>15.256803</Duration>
            <Index>1</Index>
            <Bitrate>64003</Bitrate>
            <CodecName>aac</CodecName>
            <Channels>1</Channels>
            <SampleFormat>fltp</SampleFormat>
            <CodecTagString>mp4a</CodecTagString>
            <SampleRate>44100</SampleRate>
            <Language>eng</Language>
            <CodecLongName>AAC (Advanced Audio Coding)</CodecLongName>
            <TimeBase>1/44100</TimeBase>
        </AudioStreams>
    </MediaStreams>
</MediaMeta>

JSON格式

{
    "MediaUri": "oss://imm-test/testcases/video.mp4",
    "RequestId": "2213B1A9-EB3D-4666-84E0-24980BCC4649",
    "MediaMeta": {
        "MediaFormat": {
            "Address": {
                "Township": "转塘街道",
                "AddressLine": "中国浙江省杭州市西湖区转塘街道石龙山西路",
                "Country": "中国",
                "City": "杭州市",
                "District": "西湖区",
                "Province": "浙江省"
            },
            "Size": 25115517,
            "NumberStreams": 2,
            "FormatLongName": "QuickTime / MOV",
            "CreationTime": "2020-10-25T09:16:09.000000Z",
            "StartTime": 0.000000,
            "FormatName": "mov,mp4,m4a,3gp,3g2,mj2",
            "Duration": 15.263,
            "Bitrate": 13164131,
            "Location": "30.134390,120.074997",
            "NumberPrograms": ""
        },
        "MediaStreams": {
            "VideoStreams": [
                {
                    "CodecTag": "0x31637661",
                    "Frames": 462,
                    "CodecTimeBase": "1373627/83160000",
                    "Rotate": "90",
                    "SampleAspectRatio": "1:1",
                    "StartTime": 0.000000,
                    "Duration": 15.262522,
                    "Index": 0,
                    "Bitrate": 13091201,
                    "CodecName": "h264",
                    "Profile": "Baseline",
                    "DisplayAspectRatio": "9:16",
                    "HasBFrames": 2,
                    "CodecTagString": "avc1",
                    "AverageFrameRate": "41580000/1373627",
                    "Language": "eng",
                    "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
                    "Level": 40,
                    "PixelFormat": "yuv420p",
                    "Height": 1920,
                    "FrameRrate": "90000/1",
                    "Width": 1080,
                    "TimeBase": "1/90000"
                }
            ],
            "SubtitleStreams": [
                {
                    "Language": "eng",
                    "Index": 2
                }
            ],
            "AudioStreams": [
                {
                    "CodecTag": "0x31637661",
                    "Frames": 656,
                    "CodecTimeBase": "1/44100",
                    "ChannelLayout": "mono",
                    "StartTime": 0.000000,
                    "Duration": 15.256803,
                    "Index": 1,
                    "Bitrate": 64003,
                    "CodecName": "aac",
                    "Channels": 1,
                    "SampleFormat": "fltp",
                    "CodecTagString": "mp4a",
                    "SampleRate": 44100,
                    "Language": "eng",
                    "CodecLongName": "AAC (Advanced Audio Coding)",
                    "TimeBase": "1/44100"
                }
            ]
        }
    }
}