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

获取媒体文件元信息，包括媒体格式信息和媒体流信息。

接口说明

请确保在使用该接口前，已充分了解智能媒体管理产品的收费方式和价格。
调用该接口前，请确保当前 Region 已经存在可用的项目（Project），详见项目管理。

调试

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

调试

授权信息

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

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

操作	访问级别	资源类型	条件关键字	关联操作
imm:DetectMediaMeta	none	Project acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}	无	无

请求参数

名称	类型	必填	描述	示例值
ProjectName	string	否	项目名称，获取方式请参见创建项目。	test-project
SourceURI	string	否	媒体文件的 OSS 地址。 OSS 地址规则为 oss://${Bucket}/${Object}，其中`${Bucket}`为和当前项目处于同一区域(Region)的 OSS Bucket 名称，`${Object}`为包含文件扩展名的文件完整路径。	oss://examplebucket/sampleobject.mp4
CredentialConfig	CredentialConfig	否	如无特殊需求，请保持留空即可。链式授权配置，非必填。更多信息，请参见使用链式授权访问其他实体资源。

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	2213B1A9-EB3D-4666-84E0-24980BC*****
Language	string	视频中使用的语言，参考标准为 ISO 639-2。	eng
Title	string	媒体文件标题。	test
VideoStreams	array	视频流数组。
VideoStreams	VideoStream	视频流信息。
AudioStreams	array	音频流数组。
AudioStreams	AudioStream	音频流信息。
Subtitles	array	字幕流数组。
Subtitles	SubtitleStream	字幕流信息。
StreamCount	long	媒体流数量。	2
ProgramCount	long	节目数量。	2
FormatName	string	格式名称。	mov,mp4,m4a,3gp,3g2,mj2
FormatLongName	string	格式名称的全称。	QuickTime / MOV
Size	long	媒体文件大小，单位为字节。	25115517
StartTime	double	媒体的起始播放时间。	0.000000
Bitrate	long	媒体文件的码率，单位为比特每秒（bit/s）。	13164131
Artist	string	艺术家。	unable
AlbumArtist	string	演唱者。	unable
Composer	string	作曲家。	unable
Performer	string	演奏者。	unable
Album	string	专辑。	unable
Duration	double	视频的总时长，单位为秒（s）。	15.263000
ProduceTime	string	视频拍摄时间，参考标准为 RFC3339Nano。	2022-04-24T02:39:57Z
LatLong	string	中心地理坐标点，是一个经纬度值。格式为纬度,经度，纬度在前，经度在后，且纬度范围为[-90,+90]，经度范围为[-180,+180]。例如 35.8,-45.91。	+120.029003,+30.283095
VideoWidth	long	媒体文件中视频画面的宽度，单位为像素（px）。	1080
VideoHeight	long	媒体文件中视频画面的高度，单位为像素（px）。	1920
Addresses	array	视频地理位置检测结果。只有视频中包含地理位置信息时，此参数才有值。
Addresses	Address	位置详细信息。

示例

正常返回示例

JSON格式

{
  "RequestId": "2213B1A9-EB3D-4666-84E0-24980BC*****",
  "Language": "eng",
  "Title": "test",
  "VideoStreams": [
    {
      "Index": 0,
      "Language": "en",
      "CodecName": "h264",
      "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
      "Profile": "High",
      "CodecTimeBase": "1373627/83160000",
      "CodecTagString": "avc1",
      "CodecTag": "0x31637661",
      "Width": 1280,
      "Height": 720,
      "HasBFrames": 2,
      "SampleAspectRatio": "1:1",
      "DisplayAspectRatio": "16:9",
      "PixelFormat": "yuv420p",
      "Level": 40,
      "FrameRate": "25/1",
      "AverageFrameRate": "25/1",
      "TimeBase": "1/12800",
      "StartTime": 0,
      "Duration": 22.88,
      "Bitrate": 5407765,
      "FrameCount": 572,
      "Rotate": "90",
      "BitDepth": 8,
      "ColorSpace": "bt709",
      "ColorRange": "tv",
      "ColorTransfer": "bt709",
      "ColorPrimaries": "bt709"
    }
  ],
  "AudioStreams": [
    {
      "Index": 1,
      "Language": "en",
      "CodecName": "aac",
      "CodecLongName": "AAC (Advanced Audio Coding)",
      "CodecTimeBase": "1/44100",
      "CodecTagString": "mp4a",
      "CodecTag": "0x6134706d",
      "TimeBase": "1/48000",
      "StartTime": 0.0235,
      "Duration": 3.690667,
      "Bitrate": 320087,
      "FrameCount": 173,
      "Lyric": "test",
      "SampleFormat": "fltp",
      "SampleRate": 48000,
      "Channels": 2,
      "ChannelLayout": "stereo"
    }
  ],
  "Subtitles": [
    {
      "Index": 2,
      "Language": "en",
      "CodecName": "mov_text",
      "CodecLongName": "MOV text",
      "CodecTagString": "tx3g",
      "CodecTag": "0x67337874",
      "StartTime": 0,
      "Duration": 71.378,
      "Bitrate": 74,
      "Content": "欢迎",
      "Width": 600,
      "Height": 30
    }
  ],
  "StreamCount": 2,
  "ProgramCount": 2,
  "FormatName": "mov,mp4,m4a,3gp,3g2,mj2",
  "FormatLongName": "QuickTime / MOV",
  "Size": 25115517,
  "StartTime": 0,
  "Bitrate": 13164131,
  "Artist": "unable",
  "AlbumArtist": "unable",
  "Composer": "unable",
  "Performer": "unable",
  "Album": "unable",
  "Duration": 15.263,
  "ProduceTime": "2022-04-24T02:39:57Z",
  "LatLong": "+120.029003,+30.283095",
  "VideoWidth": 1080,
  "VideoHeight": 1920,
  "Addresses": [
    {
      "Language": "zh-Hans",
      "AddressLine": "中国浙江省杭州市余杭区文一西路969号",
      "Country": "中国",
      "Province": "浙江省",
      "City": "杭州市",
      "District": "余杭区",
      "Township": "文一西路"
    }
  ]
}

错误码

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

变更历史

变更时间	变更内容概要	操作

暂无变更历史