调用GetMediaMeta获取多媒体文件信息_智能媒体管理(IMM)-阿里云帮助中心

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

接口说明

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

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
Project	string	是	项目名称。	immvideotest
MediaUri	string	是	视频的 OSS URI。 OSS 地址规则为`oss://bucket/object`，其中 bucket 为和当前项目处于同一区域的 OSS Bucket 名称，object 为文件路径。	oss://imm-test/testcases/video.mp4

返回参数

名称	类型	描述	示例值
	object
MediaUri	string	视频的 OSS URI。	oss://imm-test/testcases/video.mp4
RequestId	string	当次请求的 Request ID。	2213B1A9-EB3D-4666-84E0-24980BCC4649
MediaMeta	object	多媒体信息。
MediaFormat	object	媒体格式信息。
CreationTime	string	视频的创建时间。	2020-10-25T09:16:09.000000Z
NumberPrograms	integer	场景梳理。当前版本不支持此参数。	2
NumberStreams	integer	媒体流数量。	2
Tag	object	标签信息。
CreationTime	string	标签创建时间。	2020-10-25T09:16:09.000000Z
Album	string	专辑。当前版本不支持此参数。	unable
AlbumArtist	string	演唱者。当前版本不支持此参数。	unable
Performer	string	演奏者。当前版本不支持此参数。	unable
Composer	string	作曲家。当前版本不支持此参数。	unable
Artist	string	艺术家。当前版本不支持此参数。	unable
Title	string	名称。当前版本不支持此参数。	unable
Language	string	语言。当前版本不支持此参数。	unable
Bitrate	string	视频的码率，单位为比特每秒（bit/s）。	13164131
StartTime	string	视频的首帧时间。	0.000000
Size	string	视频文件大小，单位为字节。	25115517
Address	object	视频地理位置检测结果。只有视频中包含地理位置信息时，检测结果才有值。
Township	string	视频地理位置所在街道（或同级）。	转塘街道
District	string	视频地理位置所在区（或同级）。	西湖区
AddressLine	string	视频地理位置的完整地址。	中国浙江省杭州市西湖区转塘街道石龙山西路
Country	string	视频地理位置所在国家或地区。	中国
City	string	视频地理位置所在城市（或同级）。	杭州市
Province	string	视频地理位置所在省（或同级）。	浙江省
FormatLongName	string	格式名称的全称。	QuickTime / MOV
Duration	string	视频的总时长。	15.263000
FormatName	string	格式名称。	mov,mp4,m4a,3gp,3g2,mj2
Location	string	视频地理位置，从 EXIF 信息中获取，格式为 lat,long，以英文逗号（,）分隔的浮点数。如果视频 EXIF 信息无此信息，则返回结果中无此参数。	30.134390,120.074997
MediaStreams	object	媒体流信息。
VideoStreams	object []	视频流信息。
Index	integer	视频流索引号。	0
CodecLongName	string	编码器名称的全称。	H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
Height	integer	视频画面高度。	1920
SampleAspectRatio	string	采样率。	1:1
AverageFrameRate	string	平均帧率。	41580000/1373627
Bitrate	string	码率，单位为比特每秒（bit/s）。	13091201
Rotate	string	视频画面旋转角度。	90
CodecTagString	string	编码器标识描述信息。	avc1
Language	string	视频中使用的语言。	eng
HasBFrames	integer	记录帧缓存大小。	2
FrameRrate	string	真实基础帧率。	90000/1
Profile	string	Profile 配置。	Baseline
StartTime	string	首帧时间。	0.000000
Frames	string	帧数。	462
CodecName	string	编码器名称。	h264
Width	integer	视频画面宽度。	1080
Duration	string	视频总时长，单位为秒。	15.262522
DisplayAspectRatio	string	视频画面显示时的宽高比例。	9:16
CodecTag	string	编码器标识。	0x31637661
CodecTimeBase	string	编码器每帧时长。	1373627/83160000
TimeBase	string	每帧时长。	1/90000
Level	integer	级别，可用于限制整体参数比率。	40
PixelFormat	string	视频的存储格式。	yuv420p
AudioStreams	object []	音频流信息。
Index	integer	音频流索引号。	1
SampleRate	string	采样率。	44100
ChannelLayout	string	声道设计。	mono
CodecLongName	string	编码器名称的全称。	AAC (Advanced Audio Coding)
Channels	integer	声道数量。	1
Bitrate	string	码率，单位为比特每秒（bit/s）。	64003
CodecTagString	string	编码器标识描述信息。	mp4a
Language	string	音频语言。	eng
StartTime	string	首帧时间。	0.000000
SampleFormat	string	采样格式。	fltp
Frames	string	帧数。	656
CodecName	string	编码器名称。	aac
Duration	string	音频总时长。	15.256803
CodecTag	string	编码器标识。	0x6134706d
CodecTimeBase	string	编码器每帧时长。	1/44100
TimeBase	string	每帧时长。	1/44100
SubtitleStreams	object []	字幕流信息。
Index	integer	字幕流索引号。	2
Language	string	字幕语言。	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"
        }
      ]
    }
  }
}

错误码

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