新增媒體__媒體接口_API使用手冊_視頻點播-阿裏雲

新增媒體

描述

新增媒體

請求參數

名稱	類型	必填項	描述
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編碼。

1.工作流觸發匹配規則

規則匹配執行策略如下：以新增文件的路徑為基礎，檢查工作流綁定的位置，如果新增文件的路徑中包含規則綁定的字符串則匹配，不包含則不匹配。如 https://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/1.flv規則：

    1、https://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/          匹配
    2、https://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/            匹配
    3、https://bucket.oss-cn-hangzhou.aliyuncs.com/A/              匹配
    4、https://bucket.oss-cn-hangzhou.aliyuncs.com/                匹配
    5、https://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/CC/         不匹配
    6、https://bucket.oss-cn-hangzhou.aliyuncs.com/A/B2/           不匹配
    7、https://bucket.oss-cn-hangzhou.aliyuncs.com/A2/B/C/         不匹配

2.匹配文件擴展名

觸發要求必須是多媒體文件，點播服務是通過文件擴展名來判斷的。文件或者沒有擴展名(文件名中不包含擴展名分割符號”.”)，或者擴展名符合下麵的規則：

類型	擴展名
視頻	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

3.媒體工作流消息

媒體工作流采用阿裏雲消息服務發送消息給視頻雲點播服務接入方，媒體工作流會在(Start/Report)活動節點完成時發送消息，若需要接收消息，需要在Start活動上設置隊列/通知名稱，媒體工作流產生的消息存儲在隊列/通知中，可以使用消息服務SDK獲取消息，消息規格如下：

名稱	類型	描述
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"
                }
            },
            "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	媒體

示例

請求示例

    https://mts.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>https://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": "https://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"
        }

最後更新：2016-11-29 13:00:20

新增媒體__媒體接口_API使用手冊_視頻點播-阿裏雲

新增媒體

上一篇：查詢媒體工作流執行實例__媒體工作流執行實例接口_API使用手冊_視頻點播-阿裏雲

下一篇：刪除媒體__媒體接口_API使用手冊_視頻點播-阿裏雲

相關內容

熱門內容

最新內容

新增媒體__媒體接口_API使用手冊_視頻點播-阿裏雲

新增媒體

上一篇： 查詢媒體工作流執行實例__媒體工作流執行實例接口_API使用手冊_視頻點播-阿裏雲

下一篇： 刪除媒體__媒體接口_API使用手冊_視頻點播-阿裏雲

相關內容

熱門內容

最新內容

上一篇：查詢媒體工作流執行實例__媒體工作流執行實例接口_API使用手冊_視頻點播-阿裏雲

下一篇：刪除媒體__媒體接口_API使用手冊_視頻點播-阿裏雲