新增媒體 - - 阿里雲

说明

如果已經配置工作流程，上傳媒體檔案到OSS後，OSS會自動通知MPS，MPS會根據OSS的Bucket，Object自動匹配啟用狀態的工作流程自動執行，因此通常情況下不需要手動調用AddMedia介面處理檔案，只有當在OSS上有存量視頻時，處理存量視頻可以用此介面，從而避免了重新上傳視頻到OSS。
媒體資訊擷取，只有在指定啟用狀態的工作流程處理時，自動擷取；不指定工作流程時，不會擷取媒體資訊。

請求參數


名稱	類型	是否必須	描述
Action	String	是	操作介面名，系統規定參數，取值：AddMedia
FileURL	String	是	媒體檔案路徑。不超過3200位元組。 URL遵循 RFC 2396(UTF8編碼，並進行URLEncode)。
Title	String	否	媒體標題。長度限制不超過128個位元組。 utf-8編碼。
Description	String	否	描述。長度限制不超過1024個位元組。 utf-8編碼。
CoverURL	String	否	封面。不超過3200位元組。 URL遵循 RFC 2396(UTF8編碼，並進行URLEncode)。
CateId	Long	否	類目ID。不允許為負數。
Tags	String	否	標籤列表。用逗號分隔，不超過16個標籤，單個標籤不能超過32個位元組， utf-8編碼。
MediaWorkflowId	String	否	媒體工作流程ID。
MediaWorkflowUserData	String	否	媒體工作流程使用者自訂資料。不超過1024位元組，要求UTF8編碼。
OverrideParams	Json	否	覆蓋參數。樣本1：HLS打包字幕覆蓋{“WebVTTSubtitleOverrides”,[{“RefActivityName”:”subtitleNode”,”WebVTTSubtitleURL”:”http://test.oss-cn-hangzhou.aliyuncs.com/subtitle1.vtt"}]}。樣本2：DASH打包字幕覆蓋 {“subtitleTransNodeName”:{“InputConfig”:{“Format”:”stl”,”InputFile”:{“URL”:”http://subtitleBucket.oss-cn-hangzhou.aliyuncs.com/package/subtitle/CENG.stl"}}}}。

工作流程觸發匹配規則
規則匹配執行策略如下：以新增檔案的路徑為基礎，檢查工作流程綁定的位置，如果新增檔案的路徑中包含規則綁定的字串則匹配，不包含則不匹配。如 http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test1.flv規則：
```
1、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/          匹配
  2、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/            匹配
  3、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/              匹配
  4、http://bucket.oss-cn-hangzhou.aliyuncs.com/                匹配
  5、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test.flv  匹配
  6、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/CC/         不匹配
  7、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B2/           不匹配
  8、http://bucket.oss-cn-hangzhou.aliyuncs.com/A2/B/C/         不匹配
```
说明請您不要配置一個工作流程的輸入路徑為另外一個工作流程的輸入路徑的首碼，否則會一個增量檔案觸發兩次工作流程執行執行個體。例如：兩個工作流程的輸入路徑分別配置test和test1，則當輸入檔案上傳到test1檔案夾下同樣滿足test首碼，因此會觸發兩次工作流程執行執行個體。

匹配副檔名

觸發要求必須是多媒體檔案，媒體庫服務是通過副檔名來判斷的。檔案或者沒有副檔名(檔案名稱中不包含副檔名分割符號“.”)，或者副檔名符合下面的規則：

说明對於swf，截圖及轉碼服務品質不保障。


類型	副檔名
視頻	3gp, asf, avi, dat, dv, flv, f4v, gif, m2t, m3u8, m4v, mj2, mjpeg, mkv, mov, mp4, mpe, mpg, mpeg, mts, ogg, qt, rm, rmvb, swf, ts, vob, wmv, webm
音頻	aac, ac3, acm, amr, ape, caf, flac, m4a, mp3, ra, wav, wma, aiff

媒體工作流程訊息

媒體工作流程採用阿里雲Message Service 發送訊息給視頻雲端服務接入方，媒體工作流程會在(Start/Report)活動節點完成時發送訊息，若需要接收訊息，需要在Start活動上設定隊列/通知名稱，媒體工作流程產生的訊息儲存在隊列/通知中，可以使用 Message ServiceSDK 擷取訊息，訊息規格如下：


名稱	類型	描述
RunId	String	工作流程執行Id。
Name	String	活動名稱。
Type	String	活動類型。範圍：Report、Start
State	String	活動狀態。範圍：Fail、Success
Code	String	錯誤碼。如果活動狀態是Fail時，會給出具體的錯誤碼。
Message	String	錯誤訊息。如果活動狀態是Fail時，會給出詳細的錯誤描述資訊。
MediaWorkflowExecution	MediaWorkflowExecution	媒體工作流程執行資訊。

JSON訊息體樣本

{
        "RunId": "8f8aba5a62ab4127ae2add18da20b0f2",
        "Name": "Act-7",
        "Type": "Report",
        "State": "Success",
        "MediaWorkflowExecution": {
            "Name": "ConcurrentSuccess",
            "RunId": "8f8aba5a62ab4127ae2add18da20b0f2",
            "Input": {
                "InputFile": {
                    "Bucket": "inputfirst",
                    "Location": "oss-test",
                    "Object": "mediaWorkflow/ConcurrentSuccess/01.wmv"
                },
                "UserData":"test"
            },
            "State": "Success",
            "MediaId": "2be491ab4cb6499cd0befe5fcf0cb670",
            "ActivityList": [
                {
                    "RunId": "8f8aba5a62ab4127ae2add18da20b0f2",
                    "Name": "Act-1",
                    "Type": "Start",
                    "State": "Success",
                    "StartTime": "2016-03-15T02: 53: 41Z",
                    "EndTime": "2016-03-15T02: 53: 41Z"
                },
                {
                    "RunId": "8f8aba5a62ab4127ae2add18da20b0f2",
                    "Name": "Act-2",
                    "Type": "Transcode",
                    "JobId": "f34b6d1429dd491faa7a6c1c8f905285",
                    "State": "Success",
                    "StartTime": "2016-03-15T02: 53: 43Z",
                    "EndTime": "2016-03-15T02: 53: 47Z"
                },
                {
                    "RunId": "8f8aba5a62ab4127ae2add18da20b0f2",
                    "Name": "Act-3",
                    "Type": "Transcode",
                    "JobId": "888ac3903ecf4898b9d790cf7f1d969e",
                    "State": "Success",
                    "StartTime": "2016-03-15T02: 53: 44Z",
                    "EndTime": "2016-03-15T02: 53: 48Z"
                },
                {
                    "RunId": "8f8aba5a62ab4127ae2add18da20b0f2",
                    "Name": "Act-5",
                    "Type": "Snapshot",
                    "JobId": "c14150be33304825a5d67cd5364c35cb",
                    "State": "Success",
                    "StartTime": "2016-03-15T02: 53: 44Z",
                    "EndTime": "2016-03-15T02: 53: 45Z"
                },
                {
                    "RunId": "8f8aba5a62ab4127ae2add18da20b0f2",
                    "Name": "Act-6",
                    "Type": "Snapshot",
                    "JobId": "8c30c30ca7324286afda1a9a1b14d03c",
                    "State": "Success",
                    "StartTime": "2016-03-15T02: 53: 48Z",
                    "EndTime": "2016-03-15T02: 53: 49Z"
                },
                {
                    "RunId": "8f8aba5a62ab4127ae2add18da20b0f2",
                    "Name": "Act-7",
                    "Type": "Report",
                    "State": "Success",
                    "StartTime": "2016-03-15T02: 53: 49Z",
                    "EndTime": "2016-03-15T02: 53: 49Z"
                }
            ],
            "CreationTime": "2016-03-15T02: 53: 39Z"
        }
    }

返回參數


名稱	類型	描述
Media	Media	媒體

樣本

請求樣本

http://mts.cn-hangzhou.aliyuncs.com?MediaWorkflowUserData=test&MediaWorkflowId=09bc2f74e39c48dd86597849e2b060f6&FileURL=http%3A%2F%2Fzzzinput-test.oss-cn-hangzhou.aliyuncs.com%2Ftail_comm-33.mp4&<公用參數>

返回樣本

XML

<AddMediaResponse>
         <Media>
           <CoverURL>http://zzyoutputbucket.oss-cn-hangzhou.aliyuncs.com/aa9bb3115da54befa74e0bd81a7a9e46%2F0.jpg</CoverURL>
           <Format>mov,mp4,m4a,3gp,3g2,mj2</Format>
           <PublishState>Published</PublishState>
           <Height>1280</Height>
           <MediaId>3e6149d5a8c944c09b1a8d2dc3e4ac65</MediaId>
           <Title>tail_comm-33.mp4</Title>
           <CreationTime>2016-09-20T03:02:40Z</CreationTime>
           <RunIdList>
             <RunId>adee42a78b1f407184a792b8777efb3c</RunId>
           </RunIdList>
           <CateId>0</CateId>
           <Duration>2.645333</Duration>
           <Width>1280</Width>
           <Fps>25.0</Fps>
           <Bitrate>1148.77</Bitrate>
           <Size>379860</Size>
         </Media>
         <RequestId>13E58723-4746-46A5-900D-B41D425A2A44</RequestId>
        </AddMediaResponse>

JSON

{
            "Media": {
                "CoverURL": "http://zzyoutputbucket.oss-cn-hangzhou.aliyuncs.com/adee42a78b1f407184a792b8777efb3c%2F0.jpg", 
                "Format": "mov,mp4,m4a,3gp,3g2,mj2", 
                "PublishState": "Published", 
                "Height": "1280", 
                "MediaId": "3e6149d5a8c944c09b1a8d2dc3e4ac65", 
                "Title": "tail_comm-33.mp4", 
                "CreationTime": "2016-09-20T03:02:40Z", 
                "RunIdList": {
                    "RunId": [
                        "cbad98d35629470fa05ff393d347fd73"
                    ]
                }, 
                "CateId": 0, 
                "Duration": "2.645333", 
                "Width": "1280", 
                "Fps": "25.0", 
                "Bitrate": "1148.77", 
                "Size": "379860"
            }, 
            "RequestId": "A29ED91C-84A2-41FE-8F7F-116531A28544"
        }