使用SubmitSyncMediaInfoJob同步擷取媒體資訊-智能媒體服務-阿里雲

調用SubmitSyncMediaInfoJob以同步模式提交媒體檔案進行媒體資訊分析。

介面說明

您可以調用本介面以同步模式對輸入的檔案進行媒體分析，適用於即時性要求較高且並發量較小的情境。如果遇到片源擷取 MediaInfo 需要耗時比較久的情況，可能會因請求逾時擷取不到資訊或者資訊不準確，推薦通過SubmitMediaInfoJob - 提交非同步媒體資訊任務介面擷取媒體資訊。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ice:SubmitSyncMediaInfoJob

create

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
Name	string	否	任務名字。	job-name
Input	object	是	任務輸入。
Type	string	是	媒體物件類型。 OSS：OSS 檔案, Media：媒資 ID。	OSS
Media	string	是	媒體值： type 為 OSS 時，為 URL, 支援 OSS 協議和 HTTP 協議。說明 URL 中的 OSS bucket 需要先添加到 IMS儲存管理後再使用。 type 為 Media 時，為媒資 ID。	oss://bucket/path/to/video.mp4
UserData	string	否	使用者資料。	user-data
ScheduleConfig	object	否	調度參數。可不填。
PipelineId	string	否	管道 ID。	e37ebee5d98b4781897f6086e89f9c56
Priority	integer	否	任務優先順序。數字越大優先順序越高，取值範圍：1~10	5

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	請求 ID	31E30781-9495-5E2D-A84D-759B0A01E262
MediaInfoJob	object	MediaInfoJobDTO
Name	string	任務名字。	job-name
TriggerSource	string	任務來源。 API: API, WorkFlow: 工作流程, Console: 控制台	API
JobId	string	任務 ID。	ab4802364a2e49208c99efab82dfa8e8
Input	object	任務輸入。
Type	string	媒體物件類型。取值： OSS: OSS 檔案。 Media: 媒資 ID。	OSS
Media	string	媒體值： type 為 OSS 時，為 URL, 支援 OSS 協議和 HTTP 協議； type 為 Media 時，為媒資 ID。	oss://bucket/path/to/video.mp4
Async	boolean	是否非同步處理。	true
UserData	string	使用者資料。	user-data
ScheduleConfig	object	調度資訊。
PipelineId	string	管道 ID。	e37ebee5d98b4781897f6086e89f9c56
Priority	integer	任務優先順序。數字越大優先順序越高，取值範圍：1~10	5
Status	string	任務狀態 Init：已提交 Success：成功 Fail：失敗	Init
SubmitResultJson	object	任務提交資訊。	{}
MediaInfoProperty	object	媒體資訊詳情。
FileBasicInfo	object	基礎檔案資訊。
MediaId	string	媒資 ID	999e68259c924f52a6be603cbb3f91cc
FileName	string	檔案名稱。	file.m3u8
FileStatus	string	檔案狀態。	Normal
FileType	string	檔案類型。	source_file
FileSize	string	檔案大小。單位：Byte。	31737
FileUrl	string	檔案 URL。	http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8
Region	string	檔案所在地區。	cn-shanghai
FormatName	string	視頻格式名稱。	hls,applehttp
Duration	string	視頻時間長度（單位：秒）。	403.039999
Bitrate	string	視頻碼率。	888.563
Width	string	寬。	848
Height	string	高。	478
AudioStreamInfoList	array<object>	音頻流資訊。
	object	音頻流資訊。
Index	string	流序號。	1
CodecName	string	編碼格式。	aac
CodecLongName	string	編碼格式名。	AAC (Advanced Audio Coding)
CodecTimeBase	string	編碼器時間基。	1/44100
CodecTagString	string	編碼器標籤名。	[15][0][0][0]
CodecTag	string	編碼器標籤。	0x000f
SampleFmt	string	採樣格式。	fltp
SampleRate	string	採樣率（單位：Hz）。	44100
Channels	string	聲道數。	2
ChannelLayout	string	聲道布局。	stereo
Timebase	string	時間基。	1/90000
StartTime	string	開始時間。	1.473556
Duration	string	時間長度。	403.039989
Bitrate	string	碼率。	0.f
Lang	string	語言。	us
VideoStreamInfoList	array<object>	視頻流資訊。
	object	視頻流資訊。
Index	string	流序號。	0
Codec_name	string	編碼格式。	h264
Codec_long_name	string	編碼格式名。	H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
Profile	string	編碼器預設。	High
Codec_time_base	string	編碼時基。	1/50
Codec_tag_string	string	編碼格式標記文本。	[27][0][0][0]
Codec_tag	string	編碼格式標記。	0x001b
Width	string	寬。	848
Height	string	高。	478
Has_b_frames	string	是否有 B 幀。取值： 0：沒有 B 幀, 1：有一個 B 幀, 2：有多個連續 B 幀。	2
Sar	string	採集點數寬高比。	478:477
Dar	string	映像顯示寬高比。	16:9
PixFmt	string	顏色儲存格式。	yuv420p
Level	string	編碼等級。	31
Fps	string	幀率。	25.0
Avg_fps	string	平均幀率。	25.0
Time_base	string	時基。	1/90000
Start_time	string	起始時間。	1.473556
Duration	string	時間長度。	403.039989
Bit_rate	string	碼率。	888.563
NumFrames	string	總幀數。	10040
Lang	string	語言。	zh
Rotate	string	視頻畫面旋轉角度。	0
SubmitTime	string	任務提交時間。格式為: yyyy-MM-ddTHH:mm:ssZ 。	2022-01-12T08:49:41Z
FinishTime	string	任務完成時間。格式為: yyyy-MM-ddTHH:mm:ssZ 。	2022-01-12T08:49:41Z
RequestId	string	請求 ID。	4879B9DE-E4B6-19DC-91F5-9D5F4DCE4168

樣本

正常返回樣本

JSON格式

{
  "RequestId": "31E30781-9495-5E2D-A84D-759B0A01E262",
  "MediaInfoJob": {
    "Name": "job-name",
    "TriggerSource": "API",
    "JobId": "ab4802364a2e49208c99efab82dfa8e8",
    "Input": {
      "Type": "OSS",
      "Media": "oss://bucket/path/to/video.mp4"
    },
    "Async": true,
    "UserData": "user-data",
    "ScheduleConfig": {
      "PipelineId": "e37ebee5d98b4781897f6086e89f9c56",
      "Priority": 5
    },
    "Status": "Init",
    "SubmitResultJson": {},
    "MediaInfoProperty": {
      "FileBasicInfo": {
        "MediaId": "999e68259c924f52a6be603cbb3f91cc",
        "FileName": "file.m3u8",
        "FileStatus": "Normal",
        "FileType": "source_file",
        "FileSize": "31737",
        "FileUrl": "http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8",
        "Region": "cn-shanghai",
        "FormatName": "hls,applehttp",
        "Duration": "403.039999",
        "Bitrate": "888.563",
        "Width": "848",
        "Height": "478"
      },
      "AudioStreamInfoList": [
        {
          "Index": "1",
          "CodecName": "aac",
          "CodecLongName": "AAC (Advanced Audio Coding)",
          "CodecTimeBase": "1/44100",
          "CodecTagString": "[15][0][0][0]",
          "CodecTag": "0x000f",
          "SampleFmt": "fltp",
          "SampleRate": "44100",
          "Channels": "2",
          "ChannelLayout": "stereo",
          "Timebase": "1/90000",
          "StartTime": "1.473556",
          "Duration": "403.039989",
          "Bitrate": "0.f",
          "Lang": "us"
        }
      ],
      "VideoStreamInfoList": [
        {
          "Index": "0",
          "Codec_name": "h264",
          "Codec_long_name": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
          "Profile": "High",
          "Codec_time_base": "1/50",
          "Codec_tag_string": "[27][0][0][0]",
          "Codec_tag": "0x001b",
          "Width": "848",
          "Height": "478",
          "Has_b_frames": "2",
          "Sar": "478:477",
          "Dar": "16:9",
          "PixFmt": "yuv420p",
          "Level": "31",
          "Fps": "25.0",
          "Avg_fps": "25.0",
          "Time_base": "1/90000",
          "Start_time": "1.473556",
          "Duration": "403.039989",
          "Bit_rate": "888.563",
          "NumFrames": "10040",
          "Lang": "zh",
          "Rotate": "0"
        }
      ]
    },
    "SubmitTime": "2022-01-12T08:49:41Z",
    "FinishTime": "2022-01-12T08:49:41Z",
    "RequestId": "4879B9DE-E4B6-19DC-91F5-9D5F4DCE4168"
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。