すべてのプロダクト
Search
ドキュメントセンター

MediaInfo APIs

最終更新日: Mar 18, 2020

Description

The SubmitMediaInfoJob API submits a media information task. Media Processing analyzes and synchronously returns the media information about your input file. You can use the QueryMediaInfoJobList API to obtain the media information analysis result.

Request parameters

Parameter Type Required or not Description
Action String Yes API of the action, system required parameter. Set this parameter to SubmitMediaInfoJob.
Input String Yes Task input, which is a JSON object, for example:
{
"Bucket":"example-bucket",
"Location":"oss-cn-hangzhou",
"Object":"example.flv"
}
The bucket permission must be granted to Media Transcoding in the console.
UserData String No Custom data, up to 1,024 bytes.

Return parameters

Name Type Description
MediaInfoJob AliyunMediaInfoJob MediaInfo task

Example

Request example

  1. http://mts.cn-hangzhou.aliyuncs.com/?Action=SubmitMediaInfoJob&Input=%7B%22Bucket%22%3A%22example-bucket%22%2C%22Location%22%3A%22oss-cn-hangzhou%22%2C%0A%22Object%22%3A%22example.flv%22%7D%0A&PipelineId=88c6ca184c0e47098a5b665e2a126797<Public Parameters>

Return example

XML

  1. <SubmitMediaInfoJobResponse>
  2. <RequestId>25818875-5F78-4A13-BEF6-D7393642CA58</RequestId>
  3. <MediaInfoJob>
  4. <JobId>88c6ca184c0e47098a5b665e2a126797</JobId>
  5. <Input>
  6. <Bucket>example-bucket</Bucket>
  7. <Location>oss-cn-hangzhou</Location>
  8. <Object>example.flv</Object>
  9. </Input>
  10. <UserData>testid-001</UserData>
  11. <State>Analyzing</State>
  12. <Properties>
  13. <Streams>
  14. <VideoStreamList>
  15. <VideoStream>
  16. <Index>1</Index>
  17. <CodecName>h264</CodecName>
  18. <CodecLongName>H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10</CodecLongName>
  19. <Profile>High</Profile>
  20. <CodecTimeBase>1001/48000</CodecTimeBase>
  21. <CodecTagString>[0][0][0][0]</CodecTagString>
  22. <CodecTag>0x0000</CodecTag>
  23. <Width>1920</Width>
  24. <Height>1080</Height>
  25. <HasBFrames>1</HasBFrames>
  26. <Sar>1:1</Sar>
  27. <Dar>16:9</Dar>
  28. <PixFmt>yuv420p</PixFmt>
  29. <Level>41</Level>
  30. <Fps>25</Fps>
  31. <AvgFPS>24000/1001</AvgFPS>
  32. <Timebase>1/1000</Timebase>
  33. <StartTime>0.042000</StartTime>
  34. <Duration>100</Duration>
  35. <Bitrate>30541090</Bitrate>
  36. <NumFrames>100</NumFrames>
  37. <Lang>eng</Lang>
  38. <NetworkCost>
  39. <PreloadTime>8</PreloadTime>
  40. <CostBandwidth>10</CostBandwidth>
  41. <AvgBitrate>300.34</AvgBitrate>
  42. </NetworkCost>
  43. </VideoStream>
  44. </VideoStreamList>
  45. <AudioStreamList>
  46. <AudioStream>
  47. <Index>1</Index>
  48. <CodecName>dca</CodecName>
  49. <CodecTimeBase>1/48000</CodecTimeBase>
  50. <CodecLongName>DCA (DTS Coherent Acoustics)</CodecLongName>
  51. <CodecTagString>[0][0][0][0]</CodecTagString>
  52. <CodecTag>0x0000</CodecTag>
  53. <SampleFmt>fltp</SampleFmt>
  54. <Samplerate>48000</Samplerate>
  55. <Channels>2</Channels>
  56. <ChannelLayout>5.1(side)</ChannelLayout>
  57. <Timebase>1/1000</Timebase>
  58. <StartTime>0.042000</StartTime>
  59. <Duration>123</Duration>
  60. <Bitrate>1536000</Bitrate>
  61. <NumFrames>123</NumFrames>
  62. <Lang>eng</Lang>
  63. </AudioStream>
  64. </AudioStreamList>
  65. <SubtitleStreamList>
  66. <SubtitleStream>
  67. <Index>3</Index>
  68. <Lang>eng</Lang>
  69. </SubtitleStream>
  70. </SubtitleStreamList>
  71. </Streams>
  72. <Format>
  73. <NumStreams>1</NumStreams>
  74. <NumPrograms>2</NumPrograms>
  75. <FormatName>matroska,webm</FormatName>
  76. <FormatLongName>Matroska / WebM</FormatLongName>
  77. <StartTime>0.042000</StartTime>
  78. <Duration>17.600000</Duration>
  79. <Size>70569598</Size>
  80. <Bitrate>32077090</Bitrate>
  81. </Format>
  82. </Properties>
  83. <Code> </Code>
  84. <Message> </Message>
  85. <PipelineId>88c6ca184c0e47098a5b665e2a126797</PipelineId>
  86. <CreationTime>2014-01-10T12:00:00Z</CreationTime>
  87. </MediaInfoJob>
  88. </SubmitMediaInfoJobResponse>

JSON

  1. {
  2. "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  3. "MediaInfoJob": [{
  4. "JobId": "88c6ca184c0e47098a5b665e2a126797",
  5. "Input": {
  6. "Bucket": "example-bucket",
  7. "Location": "oss-cn-hangzhou",
  8. "Object": "example.flv"
  9. },
  10. "Properties":{
  11. "Streams":{
  12. "VideoStreamList":{
  13. "VideoStream":[
  14. {
  15. "Index":"1",
  16. "CodecName":"h264",
  17. "CodecLongName":"H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
  18. "Profile":"High",
  19. "CodecTimeBase":"1001/48000",
  20. "CodecTagString":"[0][0][0][0]",
  21. "CodecTag":"0x0000",
  22. "Width":"1920",
  23. "Height":"1080",
  24. "HasBFrames":"1",
  25. "Sar":"1:1",
  26. "Dar":"16:9",
  27. "PixFmt":"yuv420p",
  28. "Level":"41",
  29. "Fps":"25",
  30. "AvgFPS":"24000/1001",
  31. "Timebase":"1/1000",
  32. "StartTime":"0.042000",
  33. "Duration":"100",
  34. "Bitrate":"30541090",
  35. "NumFrames":"100",
  36. "Lang":"eng",
  37. "NetworkCost":{
  38. "PreloadTime":"8",
  39. "CostBandwidth":"10",
  40. "AvgBitrate":"300.34"
  41. }
  42. }]
  43. },
  44. "AudioStreamList":{
  45. "AudioStream":[
  46. {
  47. "Index":"1",
  48. "CodecName":"dca",
  49. "CodecTimeBase":"1/48000",
  50. "CodecLongName":"DCA (DTS Coherent Acoustics)",
  51. "CodecTagString":"[0][0][0][0]",
  52. "CodecTag":"0x0000",
  53. "SampleFmt":"fltp",
  54. "Samplerate":"48000",
  55. "Channels":"2",
  56. "ChannelLayout":"5.1(side)",
  57. "Timebase":"1/1000",
  58. "StartTime":"0.042000",
  59. "Duration":"123",
  60. "Bitrate":"1536000",
  61. "NumFrames":"123",
  62. "Lang":"eng"
  63. }
  64. ]},
  65. "SubtitleStreamList":{
  66. "SubtitleStream":[
  67. {
  68. "Index":"3",
  69. "Lang":"eng"
  70. }
  71. ]},
  72. "Format":{
  73. "NumStreams":"1",
  74. "NumPrograms":"2",
  75. "FormatName":"matroska,webm",
  76. "FormatLongName":"Matroska / WebM",
  77. "StartTime":"0.042000",
  78. "Duration":"17.600000",
  79. "Size":"70569598",
  80. "Bitrate":"32077090"},
  81. "UserData":"testid-001",
  82. "State": "Analyzing",
  83. "Code": "",
  84. "Message": "",
  85. "PipelineId": "88c6ca184c0e47098a5b665e2a126797",
  86. "CreationTime”:”2014-01-10T12:00:00Z"
  87. }
  88. }
  89. }]
  90. }