在使用智能媒体服务媒资上传或处理已上传的媒资时,您可以基于工作流模板进行媒体处理。本文介绍工作流的基本概念及使用方式。
功能概览
基本概念
基本概念 | 说明 |
媒体工作流(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接收消息,获取该次工作流执行的相关信息。
工作流常用场景
审核+转码串行
此流程表示视频进入到智能媒体服务后,先进行审核操作,然后进行转码操作的串行化处理。
审核+转码并行
此操作表示视频进入到点播后,同时进行审核和转码的操作。
多路转码并行
该流程会按照设置的多路转码节点进行多码流输出。