阅读345 返回首页    go 阿里云 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使用手册_视频点播-阿里云