配置工作流模板(新)

在使用智能媒体服务媒资上传或处理已上传的媒资时,您可以基于工作流模板进行媒体处理。本文介绍工作流的基本概念及使用方式。

功能概览

基本概念

基本概念

说明

媒体工作流(MediaWorkflow)

工作流是预先编排好的一系列任务流程,可以实现在指定(或任意)OSS Bucket上传一个文件后,自动(或手动)触发按照预先编排好的环节和条件依次执行作业。由媒体工作流ID(MediaWorkflowId)唯一标识。

节点/活动(Activity)

工作流中的每个节点(即一个单任务操作)称为活动。每个工作流必须包含开始和结束节点,中间节点可以自由编排。根据当前区域,支持添加转码、截图、智能审核、视频DNA、智能封面任务。

输入来源(MediaType)

触发工作流的媒体文件来源,支持媒资库媒资和对象存储文件两种输入源。

触发方式(TriggerMode)

仅输入来源为对象存储(OSS)时可设置工作流触发方式,支持自动触发(默认)、手动触发。

工作流任务实例(TaskId)

工作流每次执行,会生成工作流任务实例(TaskId)作为唯一标识。

媒体ID(MediaId)

媒体包含一个音视频输入相关的所有输出(例如:转码、截图、封面、媒体信息、审核结果、AI标签等)。输入和媒体是一一对应的,由媒体ID唯一标识。通过工作流生成的所有信息都属于这个媒体ID。

应用场景

  • UGC视频生产,上传后先通过审核、DNA过滤低质内容,只对审核通过和非重复内容进行转码和标签处理。

使用限制

  • 每个用户(指每个阿里云账号)在每个服务地域默认可创建10个工作流。

  • 不同地域功能支持情况不同,工作流支持的活动也不相同。功能支持情况请参见服务地域

工作流使用

创建工作流

重要
  • 工作流创建后,将自动激活为启用状态。以对象存储(OSS)为输入源,且触发模式为自动触发时,无论以何种方式新增上传(OSS上传、控制台上传)至工作流绑定的输入路径的文件,只要满足触发规则,就会自动触发工作流执行。

  1. 进入智能媒体服务控制台配置管理>工作流模板

  2. 在顶部左上角根据实际情况选择地域。

  3. 点击自定义页签,进入工作流自定义配置页面。

  4. 点击创建工作流模板,进入工作流模板界面。

    image

    参数

    描述

    模板名称

    工作流模板名称。由1~64位大小写字母、中文、数字、下划线(_)、短划线(-)组成。

    模板描述

    模板描述。

    事件回调

    • 使用统一回调配置:使用回调设置中配置的HTTP请求或MNS队列,详情请参见设置回调事件

    • 使用独立回调配置:仅对使用工作流模板的子任务生效。

    回调方式

    事件回调使用独立回调配置时,可以选择回调方式为HTTP请求MNS队列

    回调URL

    接收消息通知的URL。当产生回调事件时,服务端会向此URL发起HTTP POST请求。

    队列名称

    接收消息通知的MNS队列。请使用ice-callback开头命名的队列,如果没有可用的队列,需要在MNS控制台创建。具体操作,请参见创建队列

    输入及输出配置

    • 媒资库:当前地域媒资库。

    • 对象存储:

      • 触发模式:上传后自动触发或手动触发。

      • 输入路径:单击选择。在Bucket下拉列表中,选择Bucket名称。路径下方会显示对应Bucket已经创建好的文件夹,在文件夹下选择一个地址作为输入路径。

    工作流节点配置

    • 单击ico_add,添加工作流节点,支持添加串行和并行节点。

    • 单击ico_modify,编辑工作流节点。

    • 单击ico_delete,删除工作流节点。

      重要

      工作流节点删除后不能恢复,如果该节点存在后续节点,则后续节点将一起被删除。

编辑/停用工作流

单击操作列指定功能,您可以对工作流模板进行查看、编辑、启用、停用、测试、复制和删除操作。

说明
  • 系统预置的工作流模板,仅支持在控制台查看、启用和停用,不支持复制、编辑和删除。

  • 状态已停用的工作流模板才支持在控制台编辑和删除,如有需要,请先停用工作流模板。

  • 状态启用中的工作流模板才可用于发起媒体处理。

  • 状态启用中内容来源为对象存储(oss)的工作流模板才支持在控制台测试工作流。

触发工作流

根据媒体文件来源,分为媒资库媒资来源触发和对象存储(oss)来源触发。其中对象存储(oss)来源触发根据文件路径、是否自动触发又分为如下表3种方式,详情请参见触发工作流

触发方式

适用场景

自动触发

新上传到输入路径且符合格式等要求的文件,会自动触发工作流执行。

手动触发(校验输入路径)

  • 历史数据处理,对已存储在OSS的文件按工作流批量处理

  • 文件上传后不需要立刻处理,比如等待有用户访问、播放量较高后再处理

  • 文件需要按业务逻辑,选择执行不同的工作流

手动触发(任意路径)

文件路径很多无法配置成统一路径,但工作流处理流程相同,需要手动提交

获取执行结果

  • 控制台查询:登录媒体处理控制台,选择点播媒体处理-任务管理-工作流,查看详情。

  • API查询:调用GetWorkflowTask - 查询工作流任务。传入TaskId,查询该次工作流执行的活动列表信息(如活动类型、状态、JobId)、MNS通知、用户自定义数据、媒体ID。

  • 配置MNS获取:在工作流的输入节点中配置工作流MNS消息。当工作流开始和完成后,媒体处理服务会向MNS发送消息,您可以通过MNS接收消息,获取该次工作流执行的相关信息。

工作流常用场景

  • 审核+转码串行

    此流程表示视频进入到智能媒体服务后,先进行审核操作,然后进行转码操作的串行化处理。image

  • 审核+转码并行

    此操作表示视频进入到点播后,同时进行审核和转码的操作。

    image

  • 多路转码并行

    该流程会按照设置的多路转码节点进行多码流输出。

    image