閱讀345 返回首頁    go 阿裏雲

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

描述

用於新增媒體工作流，定義媒體工作流的拓撲結構

請求參數

名稱 類型 必填項 描述
Action String 是 操作接口名，係統規定參數，取值：AddMediaWorkflow
Name String 是 媒體工作流名稱，不能為空串，不可重複，不超過64個字符，utf-8編碼
Topology String 是 媒體工作流拓撲結構，Json對象，包括活動列表及活動依賴，見Topology示例。

Topology示例：

  1.      {
  2.         "Activities": {
  3.             "Act-Transcode-M3U8": {
  4.                 "Parameters": {
  5.                     "Outputs": "[{"Object":"transcode/{ObjectPrefix}{FileName}","TemplateId": "957d1719ee85ed6527b90cf62726cbef"}]",
  6.                     "OutputBucket": "panda-vod-hls",
  7.                     "OutputLocation": "oss-cn-hangzhou"
  8.                 },
  9.                 "Type": "Transcode"
  10.             },
  11.             "Act-Start": {
  12.                 "Name": "Act-Start",
  13.                 "Parameters": {
  14.                     "PipelineId": "130266f58161436a80bf07cb12c8009a",
  15.                     "InputFile": "{"Bucket": "panda-vod","Location": "oss-cn-hangzhou"}"
  16.                 },
  17.                 "Type": "Start"
  18.             },
  19.             "Act-Report": {
  20.                 "Name": "Act-Report",
  21.                 "Parameters": {},
  22.                 "Type": "Report"
  23.             }
  24.         },
  25.         "Dependencies": {
  26.             "Act-Transcode-M3U8": [
  27.                 "Act-Report"
  28.             ],
  29.             "Act-Start": [
  30.                 "Act-Transcode-M3U8"
  31.             ],
  32.             "Act-Report": []
  33.         }
  34.     }

Start活動，設定媒體工作流的工作空間，以及全局配置，開始活動支持的參數

名稱 類型 必填項 描述
InputFile String 是 輸入位置，示例：{“Bucket”: “example-001”,”Location”: “oss-cn-hangzhou”, “ObjectPrefix”: “test/“}
PipelineId String 是 管道ID,全局配置
MessageType String 否 消息類別,默認Queue,範圍：Queue,Topic
QueueName String 否 隊列名稱,全局配置
TopicName String 否 主題名稱,全局配置
RoleName String 否 授權角色名稱,默認值：AliyunMTSDefaultRole,全局配置

Transcode活動支持的參數

名稱 類型 必填項 描述
Outputs String 是 參考Output詳情，示例：[{“Object”:”transcode/{ObjectPrefix}/{FileName}.{ExtName}”,”TemplateId”: “S00000001-000070”}]，其中參數Object是輸出文件的動態規則，目前支持對原文件{ObjectPrefix},{FileName},{ExtName},{DestMd5},{DestAvgBitrate}以及媒體工作流信息{RunId},{MediaId},{TemplateId}的動態替換。
OutputBucket String 是 輸出Bucket
OutputLocation String 否 輸出區域

Snapshot活動支持的參數

名稱 類型 必填項 描述
SnapshotConfig String 是 參考截圖參數配置詳情，示例：{“OutputFile”: {“Bucket”: “example-001”, “Location”: “oss-cn-hangzhou”, “Object”: “snapshot/{ObjectPrefix}/{FileName}.{ExtName}/1.jpg”},”Time”: “5”}，其中參數Object是輸出文件的動態規則，目前支持對原文件{ObjectPrefix},{FileName},{ExtName}以及媒體工作流信息{RunId},{MediaId}的動態替換，還支持對截圖時間點{SnapshotTime}的替換。
MediaCover String 否 是否設置成媒體封麵，隻針對單張截圖，默認是false,範圍：true,false

Analysis活動支持的參數

無

Report活動支持的參數

名稱 類型 必填項 描述
PublishType String 否 媒體發布類型，範圍:Auto、Manual，Auto自動發布，Manual就是不發布，默認值：Manual

返回參數

名稱 類型 描述
MediaWorkflow MediaWorkflow 媒體工作流

示例

請求示例

  1. https://mts.aliyuncs.com/?Name=mediaworkflow-test&Action=AddMediaWorkflow&Topology=%7B%22Activities%22%3A%7B%22Act-Transcode-M3U8%22%3A%7B%22Parameters%22%3A%7B%22Outputs%22%3A%22%5B%7B%5C%22Object%5C%22%3A%5C%22transcode%2F%7BObjectPrefix%7D%7BFileName%7D%5C%22%2C%5C%22TemplateId%5C%22%3A%20%5C%22957d1719ee85ed6527b90cf62726cbef%5C%22%7D%5D%22%2C%22OutputBucket%22%3A%22panda-vod-hls%22%2C%22OutputLocation%22%3A%22oss-cn-hangzhou%22%7D%2C%22Type%22%3A%22Transcode%22%7D%2C%22Act-Start%22%3A%7B%22Name%22%3A%22Act-Start%22%2C%22Parameters%22%3A%7B%22PipelineId%22%3A%22130266f58161436a80bf07cb12c8009a%22%2C%22InputFile%22%3A%22%7B%5C%22Bucket%5C%22%3A%20%5C%22panda-vod%5C%22%2C%5C%22Location%5C%22%3A%20%5C%22oss-cn-hangzhou%5C%22%7D%22%7D%2C%22Type%22%3A%22Start%22%7D%2C%22Act-Report%22%3A%7B%22Name%22%3A%22Act-Report%22%2C%22Parameters%22%3A%7B%7D%2C%22Type%22%3A%22Report%22%7D%7D%2C%22Dependencies%22%3A%7B%22Act-Transcode-M3U8%22%3A%5B%22Act-Report%22%5D%2C%22Act-Start%22%3A%5B%22Act-Transcode-M3U8%22%5D%2C%22Act-Report%22%3A%5B%5D%7D%7D&<公共參數>

返回示例

XML:

  1.     <AddMediaWorkflowResponse> 
  2.       <RequestId>F1D21261-ADB9-406A-BF6F-491382139D59</RequestId>  
  3.       <MediaWorkflow> 
  4.         <CreationTime>2016-04-01T05:29:37Z</CreationTime>  
  5.         <Name>mediaworkflow-test</Name>  
  6.         <State>Inactive</State>  
  7.         <Topology>{"Activities":{"Act-Start":{"Parameters":{"PipelineId":"130266f58161436a80bf07cb12c8009a","InputFile":"{"Bucket": "panda-vod","Location": "oss-cn-hangzhou"}"},"Type":"Start"},"Act-Report":{"Parameters":{},"Type":"Report"},"Act-Transcode-M3U8":{"Parameters":{"Outputs":"[{"Object":"transcode/{ObjectPrefix}{FileName}","TemplateId": "957d1719ee85ed6527b90cf62726cbef"}]","OutputBucket":"panda-vod-hls","OutputLocation":"oss-cn-hangzhou"},"Type":"Transcode"}},"Dependencies":{"Act-Start":["Act-Transcode-M3U8"],"Act-Report":[],"Act-Transcode-M3U8":["Act-Report"]}}</Topology>  
  8.         <MediaWorkflowId>e00732b977da427d9177a4dee646b1aa</MediaWorkflowId> 
  9.       </MediaWorkflow> 
  10.     </AddMediaWorkflowResponse>

Json:

  1.     {
  2.         "RequestId": "F1D21261-ADB9-406A-BF6F-491382139D59",
  3.         "MediaWorkflow": {
  4.             "CreationTime": "2016-04-01T05:29:37Z",
  5.             "Name": "mediaworkflow-test",
  6.             "State": "Inactive",
  7.             "Topology": "{"Activities":{"Act-Start":{"Parameters":{"PipelineId":"130266f58161436a80bf07cb12c8009a","InputFile":"{\"Bucket\": \"panda-vod\",\"Location\": \"oss-cn-hangzhou\"}"},"Type":"Start"},"Act-Report":{"Parameters":{},"Type":"Report"},"Act-Transcode-M3U8":{"Parameters":{"Outputs":"[{\"Object\":\"transcode/{ObjectPrefix}{FileName}\",\"TemplateId\": \"957d1719ee85ed6527b90cf62726cbef\"}]","OutputBucket":"panda-vod-hls","OutputLocation":"oss-cn-hangzhou"},"Type":"Transcode"}},"Dependencies":{"Act-Start":["Act-Transcode-M3U8"],"Act-Report":[],"Act-Transcode-M3U8":["Act-Report"]}}",
  8.             "MediaWorkflowId": "93ab850b4f6f44eab54b6e91d24d81d4"
  9.         }
  10.     }

最後更新：2016-11-23 16:04:19

  上一篇：go 調用示例__調用方式_API使用手冊_視頻點播-阿裏雲
  下一篇：go 激活媒體工作流__媒體工作流接口_API使用手冊_視頻點播-阿裏雲