在使用智能媒体服务媒资上传或处理已上传的媒资时,您可以基于工作流模板进行媒体处理。本文介绍工作流的基本概念及使用方式。
功能概览
基本概念
| 基本概念 | 说明 | 
| 媒体工作流(MediaWorkflow) | 工作流是预先编排好的一系列任务流程,可以实现在指定(或任意)OSS Bucket上传一个文件后,自动(或手动)触发按照预先编排好的环节和条件依次执行作业。由媒体工作流ID(MediaWorkflowId)唯一标识。 | 
| 节点/活动(Activity) | 工作流中的每个节点(即一个单任务操作)称为活动。每个工作流必须包含开始和结束节点,中间节点可以自由编排。根据当前区域,支持添加转码、截图、智能审核、视频DNA、智能封面任务。 | 
| 输入来源(MediaType) | 触发工作流的媒体文件来源,支持媒资库媒资和对象存储文件两种输入源。 | 
| 触发方式(TriggerMode) | 仅输入来源为对象存储(OSS)时可设置工作流触发方式,支持自动触发(默认)、手动触发。 | 
| 工作流任务实例(TaskId) | 工作流每次执行,会生成工作流任务实例(TaskId)作为唯一标识。 | 
| 媒体ID(MediaId) | 媒体包含一个音视频输入和相关的所有输出(例如:转码、截图、封面、媒体信息、审核结果、AI标签等)。输入和媒体是一一对应的,由媒体ID唯一标识。通过工作流生成的所有信息都属于这个媒体ID。 | 
应用场景
- UGC视频生产,上传后先通过审核、DNA过滤低质内容,只对审核通过和非重复内容进行转码和标签处理。 
使用限制
- 每个用户(指每个阿里云账号)在每个服务地域默认可创建10个工作流。 
- 不同地域功能支持情况不同,工作流支持的活动也不相同。功能支持情况请参见服务地域。 
工作流使用
创建工作流
- 工作流创建后,将自动激活为启用状态。以对象存储(OSS)为输入源,且触发模式为自动触发时,无论以何种方式新增上传(OSS上传、控制台上传)至工作流绑定的输入路径的文件,只要满足触发规则,就会自动触发工作流执行。 
- 进入智能媒体服务控制台配置管理>工作流模板。 
- 在顶部左上角根据实际情况选择地域。 
- 点击自定义页签,进入工作流自定义配置页面。 
- 点击创建工作流模板,进入工作流模板界面。  - 参数 - 描述 - 模板名称 - 工作流模板名称。由1~64位大小写字母、中文、数字、下划线(_)、短划线(-)组成。 - 模板描述 - 模板描述。 - 事件回调 - 使用统一回调配置:使用回调设置中配置的HTTP请求或MNS队列,详情请参见设置回调事件。 
- 使用独立回调配置:仅对使用工作流模板的子任务生效。 
 - 回调方式 - 当事件回调为使用独立回调配置时,可以选择回调方式为HTTP请求或MNS队列。 - 回调URL - 接收消息通知的URL。当产生回调事件时,服务端会向此URL发起HTTP POST请求。 - 队列名称 - 接收消息通知的MNS队列。请使用ice-callback开头命名的队列,如果没有可用的队列,需要在MNS控制台创建。具体操作,请参见创建队列。 - 输入及输出配置 - 媒资库:当前地域媒资库。 
- 对象存储: - 触发模式:上传后自动触发或手动触发。 
- 输入路径:单击选择。在Bucket下拉列表中,选择Bucket名称。路径下方会显示对应Bucket已经创建好的文件夹,在文件夹下选择一个地址作为输入路径。 
 
 - 工作流节点配置 - 单击  ,添加工作流节点,支持添加串行和并行节点。 ,添加工作流节点,支持添加串行和并行节点。
- 单击  ,编辑工作流节点。 ,编辑工作流节点。
- 单击  ,删除工作流节点。重要 ,删除工作流节点。重要- 工作流节点删除后不能恢复,如果该节点存在后续节点,则后续节点将一起被删除。 
 
编辑/停用工作流
单击操作列指定功能,您可以对工作流模板进行查看、编辑、启用、停用、测试、复制和删除操作。
- 系统预置的工作流模板,仅支持在控制台查看、启用和停用,不支持复制、编辑和删除。 
- 仅状态为已停用的工作流模板才支持在控制台编辑和删除,如有需要,请先停用工作流模板。 
- 仅状态为启用中的工作流模板才可用于发起媒体处理。 
- 仅状态为启用中且内容来源为对象存储(oss)的工作流模板才支持在控制台测试工作流。 
触发工作流
根据媒体文件来源,分为媒资库媒资来源触发和对象存储(oss)来源触发。其中对象存储(oss)来源触发根据文件路径、是否自动触发又分为如下表3种方式,详情请参见触发工作流。
| 触发方式 | 适用场景 | 
| 自动触发 | 新上传到输入路径且符合格式等要求的文件,会自动触发工作流执行。 | 
| 手动触发(校验输入路径) | 
 | 
| 手动触发(任意路径) | 文件路径很多无法配置成统一路径,但工作流处理流程相同,需要手动提交 | 
获取执行结果
- 控制台查询:登录媒体处理控制台,选择点播媒体处理-任务管理-工作流,查看详情。 
- API查询:调用GetWorkflowTask - 查询工作流任务。传入TaskId,查询该次工作流执行的活动列表信息(如活动类型、状态、JobId)、MNS通知、用户自定义数据、媒体ID。 
- 配置MNS获取:在工作流的输入节点中配置工作流MNS消息。当工作流开始和完成后,媒体处理服务会向MNS发送消息,您可以通过MNS接收消息,获取该次工作流执行的相关信息。 
工作流常用场景
- 审核+转码串行 - 此流程表示视频进入到智能媒体服务后,先进行审核操作,然后进行转码操作的串行化处理。  
- 审核+转码并行 - 此操作表示视频进入到点播后,同时进行审核和转码的操作。  
- 多路转码并行 - 该流程会按照设置的多路转码节点进行多码流输出。 