GetMediaMeta - 获取多媒体文件信息

获取多媒体文件信息,如编码、码率、分辨率、流信息等。

接口说明

此接口已不再维护,建议使用新版(2020-09-30 版本)接口 DetectMediaMeta 。关于新版与旧版 API 的对比,请参见新旧版本使用指引中的新版与旧版 API 对应关系说明章节。

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
imm:GetMediaMetaget
*全部资源
*

请求参数

名称类型必填描述示例值
Projectstring

项目名称。

immvideotest
MediaUristring

视频的 OSS URI。

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

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

返回参数

名称类型描述示例值
object
MediaUristring

视频的 OSS URI。

oss://imm-test/testcases/video.mp4
RequestIdstring

当次请求的 Request ID。

2213B1A9-EB3D-4666-84E0-24980BCC4649
MediaMetaobject

多媒体信息。

MediaFormatobject

媒体格式信息。

CreationTimestring

视频的创建时间。

2020-10-25T09:16:09.000000Z
NumberProgramsinteger

场景梳理。当前版本不支持此参数。

2
NumberStreamsinteger

媒体流数量。

2
Tagobject

标签信息。

CreationTimestring

标签创建时间。

2020-10-25T09:16:09.000000Z
Albumstring

专辑。当前版本不支持此参数。

unable
AlbumArtiststring

演唱者。当前版本不支持此参数。

unable
Performerstring

演奏者。当前版本不支持此参数。

unable
Composerstring

作曲家。当前版本不支持此参数。

unable
Artiststring

艺术家。当前版本不支持此参数。

unable
Titlestring

名称。当前版本不支持此参数。

unable
Languagestring

语言。当前版本不支持此参数。

unable
Bitratestring

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

13164131
StartTimestring

视频的首帧时间。

0.000000
Sizestring

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

25115517
Addressobject

视频地理位置检测结果。

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

Townshipstring

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

转塘街道
Districtstring

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

西湖区
AddressLinestring

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

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

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

中国
Citystring

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

杭州市
Provincestring

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

浙江省
FormatLongNamestring

格式名称的全称。

QuickTime / MOV
Durationstring

视频的总时长。

15.263000
FormatNamestring

格式名称。

mov,mp4,m4a,3gp,3g2,mj2
Locationstring

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

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

30.134390,120.074997
MediaStreamsobject

媒体流信息。

VideoStreamsarray<object>

视频流信息。

VideoStreamobject
Indexinteger

视频流索引号。

0
CodecLongNamestring

编码器名称的全称。

H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
Heightinteger

视频画面高度。

1920
SampleAspectRatiostring

采样率。

1:1
AverageFrameRatestring

平均帧率。

41580000/1373627
Bitratestring

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

13091201
Rotatestring

视频画面旋转角度。

90
CodecTagStringstring

编码器标识描述信息。

avc1
Languagestring

视频中使用的语言。

eng
HasBFramesinteger

记录帧缓存大小。

2
FrameRratestring

真实基础帧率。

90000/1
Profilestring

Profile 配置。

Baseline
StartTimestring

首帧时间。

0.000000
Framesstring

帧数。

462
CodecNamestring

编码器名称。

h264
Widthinteger

视频画面宽度。

1080
Durationstring

视频总时长,单位为秒。

15.262522
DisplayAspectRatiostring

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

9:16
CodecTagstring

编码器标识。

0x31637661
CodecTimeBasestring

编码器每帧时长。

1373627/83160000
TimeBasestring

每帧时长。

1/90000
Levelinteger

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

40
PixelFormatstring

视频的存储格式。

yuv420p
AudioStreamsarray<object>

音频流信息。

AudioStreamobject
Indexinteger

音频流索引号。

1
SampleRatestring

采样率。

44100
ChannelLayoutstring

声道设计。

mono
CodecLongNamestring

编码器名称的全称。

AAC (Advanced Audio Coding)
Channelsinteger

声道数量。

1
Bitratestring

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

64003
CodecTagStringstring

编码器标识描述信息。

mp4a
Languagestring

音频语言。

eng
StartTimestring

首帧时间。

0.000000
SampleFormatstring

采样格式。

fltp
Framesstring

帧数。

656
CodecNamestring

编码器名称。

aac
Durationstring

音频总时长。

15.256803
CodecTagstring

编码器标识。

0x6134706d
CodecTimeBasestring

编码器每帧时长。

1/44100
TimeBasestring

每帧时长。

1/44100
SubtitleStreamsarray<object>

字幕流信息。

SubtitleStreamobject
Indexinteger

字幕流索引号。

2
Languagestring

字幕语言。

eng

示例

正常返回示例

JSON格式

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

错误码

访问错误中心查看更多错误码。