媒体处理中的工作流是指通过配置多个单任务操作组合对一个输入进行自动化处理的过程。本文介绍媒体处理服务中媒体工作流的基本概念及执行规则,以便您更好的理解和使用媒体处理服务。
基本概念
- 媒体
媒体包含一个输入(视频、音频多媒体文件)和相关的所有输出(例如:转码、截图、媒体信息、AI标签等)。输入和媒体是一一对应的,由媒体ID唯一标识。
- 媒体库
媒体库是所有媒体的集合,媒体是媒体库的最小管理单元。
- 媒体工作流
媒体工作流是自动化生产媒体的工厂,由媒体工作流ID(MediaWorkflowId)唯一标识。
- 活动工作流中的每个节点(即一个单任务操作)称为活动。根据实际需求,既可以并行执行(例如,示意图的作业A1、B、C之间),也可以串行执行(例如:示意图的作业A1、A2之间)。除开始的输入活动和结束的发布汇报活动外,活动也支持各种类型的作业(转码作业、截图作业等)。说明 不同地域功能支持情况不同,工作流支持的活动也不相同。功能支持情况请参见服务地域。
- 开始的输入活动
配置工作流关联存储的触发路径,只要在对应的路径上传视频、音频多媒体文件,就会自动触发工作流执行。
- 结束的发布汇报活动
工作流执行完成后,会向消息服务指定的队列或主题发送消息通知执行结果。执行结果包含了媒体ID和多媒体文件的绝对地址,这样就能对应具体是哪个多媒体文件执行完成。
- 作业活动
作业支持的所有参数,都可以在作业活动中配置。
- 开始的输入活动
- 路径匹配规则
当有新的媒体文件进入匹配路径时自动触发工作流。匹配使用路径前缀的规则,例如:上传的文件路径为http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/A/B/C/video_01.flv,配置的触发路径结果如下:
OSS路径 是否匹配 http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/A/B/C/ 是 http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/A/B/C2/ 否 http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/A/B 是 http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/A/B2/ 否 http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/A/ 是 http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/A2/B/C/ 否 http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/A/B/C/video 是 http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/A/B/C/video_01 否 - 扩展名匹配规则
上传时的自动触发机制会检查文件的扩展名,避免产生一些无效的数据(例如pdf、word文档等)。说明 API手动触发机制不检查扩展名。文件没有扩展名(文件名中不包含扩展名分割符号”.”),或者扩展名符合下面的规则即为有效。
- 视频
.3gp、.asf、.avi、.dat、.dv、.flv、.f4v、.gif、.m2t、.m3u8、.m4v、.mj2、.mjpeg、.mkv、.mov、.mp4、.mpe、.mpg、.mpeg、.mts、.ogg、.qt、.rm、.rmvb、.swf、.ts、.vob、.wmv、.webm
- 音频
.aac、.ac3、.acm、.amr、.ape、.caf、.flac、.m4a、.mp3、.ra、.wav、.wma、.aiff
- 视频
- 工作流执行
分为自动触发机制和API手动触发机制。
- 自动触发机制:每次上传匹配的多媒体文件都会触发一次执行,同一个多媒体文件如果多次上传,则会触发多次执行,每次执行有唯一的RunId标识。
- API手动触发机制:每次调用API都会触发一次执行,主要针对存储中的存量多媒体文件而设置。
- 用户数据
每次执行时,可以填写自定义的用户数据参数(例如:商品ID),然后消息通知中会返回自定义的用户数据参数。这样使用自定义的用户数据就可以关联业务系统,不需要再在业务系统中记录媒体ID或者多媒体文件的绝对路径。
- 活动