全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
媒体转码

新增媒体工作流

更新时间:2017-10-27 15:26:47

新增媒体工作流

描述

用于新增媒体工作流,定义媒体工作流的拓扑结构

请求参数

名称 类型 必填项 描述
Action String 操作接口名,系统规定参数,取值:AddMediaWorkflow
Name String 媒体工作流名称,不能为空串,不可重复,不超过64个字符,utf-8编码
Topology String 媒体工作流拓扑结构,Json对象,包括活动列表及活动依赖,见Topology示例。

Topology示例:

  1. {
  2. "Activities": {
  3. "Act-Transcode-M3U8": {
  4. "Parameters": {
  5. "Outputs": [
  6. {
  7. "OutputObject": "transcode%2F%7BObjectPrefix%7D%7BFileName%7D",
  8. "TemplateId": "957d1719ee85ed6527b90cf62726cbef"
  9. }
  10. ],
  11. "OutputBucket": "panda-vod-hls",
  12. "OutputLocation": "oss-cn-hangzhou"
  13. },
  14. "Type": "Transcode"
  15. },
  16. "Act-Start": {
  17. "Name": "Act-Start",
  18. "Parameters": {
  19. "PipelineId": "130266f58161436a80bf07cb12c8009a",
  20. "InputFile": {
  21. "Bucket": "panda-vod",
  22. "Location": "oss-cn-hangzhou"
  23. }
  24. },
  25. "Type": "Start"
  26. },
  27. "Act-Report": {
  28. "Name": "Act-Report",
  29. "Parameters": {
  30. },
  31. "Type": "Report"
  32. }
  33. },
  34. "Dependencies": {
  35. "Act-Transcode-M3U8": [
  36. "Act-Report"
  37. ],
  38. "Act-Start": [
  39. "Act-Transcode-M3U8"
  40. ],
  41. "Act-Report": [
  42. ]
  43. }
  44. }

Start活动,设定媒体工作流的工作空间,以及全局配置,开始活动支持的参数。工作流触发匹配规则

名称 类型 必填项 描述
InputFile String 输入位置,示例:{“Bucket”: “example-001”,”Location”: “oss-cn-hangzhou”, “ObjectPrefix”: “test/“}
PipelineId String 管道ID,全局配置,工作流场景,管道上的消息配置无效,QueueName/TopicName的消息配置有效
MessageType String 消息类别,默认Queue,范围:Queue,Topic
QueueName String 队列名称,全局配置
TopicName String 主题名称,全局配置
RoleName String 授权角色名称,默认值:AliyunMTSDefaultRole,全局配置

Transcode活动支持的参数

名称 类型 必填项 描述
Outputs String 参考Output详情,示例:[{“OutputObject”:”transcode%2F%7BObjectPrefix%7D%2F%7BFileName%7D.%7BExtName%7D”,”TemplateId”: “S00000001-000070”}]。
OutputBucket String 输出Bucket
OutputLocation String 输出区域

Snapshot活动支持的参数

名称 类型 必填项 描述
SnapshotConfig String 参考截图参数配置详情,示例:{“OutputFile”: {“Bucket”: “example-001”, “Location”: “oss-cn-hangzhou”, “Object”:”snapshot%2F%7BObjectPrefix%7D%2F%7BFileName%7D.%7BExtName%7D%2F1.jpg”},”Time”: “5”}。
MediaCover String 是否设置成媒体封面,只针对单张截图,默认是false,范围:true,false

Analysis活动支持的参数

Report活动支持的参数

名称 类型 必填项 描述
PublishType String 媒体发布类型,范围:Auto、Manual、TranscodeCompletedAuto。Auto表示工作流执行完成后自动发布,Manual表示不发布,TranscodeCompletedAuto表示任一转码活动完成后自动发布(使用Start节点的消息配置通知用户转码完成,而且可以使用播放服务播放该活动输出),默认值:Manual

返回参数

名称 类型 描述
MediaWorkflow MediaWorkflow 媒体工作流

示例

请求示例

  1. https://mts.cn-hangzhou.aliyuncs.com/?Name=mediaworkflow-test&Action=AddMediaWorkflow&Topology=%7B%22Activities%22%3A%7B%22Act-Start%22%3A%7B%22Parameters%22%3A%7B%22PipelineId%22%3A%22130266f58161436a80bf07cb12c8009a%22%2C%22InputFile%22%3A%22%7B%5C%22Bucket%5C%22%3A+%5C%22panda-vod%5C%22%2C%5C%22Location%5C%22%3A+%5C%22oss-cn-hangzhou%5C%22%7D%22%7D%2C%22Type%22%3A%22Start%22%7D%2C%22Act-Report%22%3A%7B%22Parameters%22%3A%7B%7D%2C%22Type%22%3A%22Report%22%7D%2C%22Act-Transcode-M3U8%22%3A%7B%22Parameters%22%3A%7B%22Outputs%22%3A%22%5B%7B%5C%22OutputObject%5C%22%3A%5C%22transcode%252F%257BObjectPrefix%257D%257BFileName%257D%5C%22%2C%5C%22TemplateId%5C%22%3A+%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%7D%2C%22Dependencies%22%3A%7B%22Act-Start%22%3A%5B%22Act-Transcode-M3U8%22%5D%2C%22Act-Report%22%3A%5B%5D%2C%22Act-Transcode-M3U8%22%3A%5B%22Act-Report%22%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":"[{\"OutputObject\":\"transcode%2F%7BObjectPrefix%7D%7BFileName%7D\",\"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\":\"[{\\\"OutputObject\\\":\\\"transcode%2F%7BObjectPrefix%7D%7BFileName%7D\\\",\\\"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. }
本文导读目录