更新时间:2024-07-16 GMT+08:00
分享

官方算子一览

本小节介绍华为云自有服务提供的各类算子的参数配置说明。

不同区域支持的算子可能不同,请以控制台实际为准。

表1 华为云官方算子一览

分类

模板名称

是否支持同步工作流

算子提供方

图像处理

图像标签

是

图像识别服务Image

人脸检测

是

人脸识别服务FRS

人脸搜索

是

人脸识别服务FRS

人脸比对

是

人脸识别服务FRS

圆角剪切

是

对象存储服务OBS

普通裁剪

是

对象存储服务OBS

索引剪切

是

对象存储服务OBS

图片水印

是

对象存储服务OBS

文字水印

是

对象存储服务OBS

缩略图

是

对象存储服务OBS

内切圆裁剪

是

对象存储服务OBS

自适应旋转

是

对象存储服务OBS

基础旋转

是

对象存储服务OBS

质量变换

是

对象存储服务OBS

格式转换

是

对象存储服务OBS

图片暗水印

是

数据安全中心DSC

视频处理

视频解析

是

媒体处理服务MPC

抽帧截图

是

媒体处理服务MPC

媒资转码

否

媒体处理服务MPC

消息通知

DIS消息通知

NA

数据接入服务DIS

SMN消息通知

NA

消息通知服务SMN

其他

事件延迟

NA

NA

自定义

NA

NA

人脸比对

模板作用:人脸比对是将两个人脸进行比对,来判断是否为同一个人,返回比对置信度。如果传入的图片中包含多个人脸,选取最大的人脸进行比对。该模板实际调用的是FRS服务的人脸比对接口。

表2 人脸比对属性配置说明

属性类别

参数名称

参数说明

基本属性

名称

任务的名称,修改后将体现在工作流编排区域。

  • 必须以字母或数字开头
  • 只能由字母、数字、下划线和中划线组成
  • 长度范围为1~20个字符
  • 不能和同一工作流中的其他任务重名

超时(秒)

任务超时时间,即任务执行的最长时间。

支持设置0~300秒的超时时间,如果设置为0,则表示超时时间为默认值30秒。

算子提供方

函数模板的提供方。

错误处理

可定义不同类型错误发生时的重试次数、重试间隔,以及重试失败后跳转到的目标任务。

错误类型包括:匹配所有、执行失败、权限不合法、参数不合法、函数不存在、请求太频繁、函数不可用、函数异常

动态参数

bucket

待对比的人脸图片存放的OBS桶名。

path

待对比的人脸图片在OBS桶中存放的目录。

人脸检测

模板作用:对输入图片进行人脸检测和分析,输出人脸在图像中的位置、人脸关键点位置和人脸关键属性。该模板实际调用的是FRS服务的人脸检测接口。

表3 人脸检测属性配置说明

属性类别

参数名称

参数说明

基本属性

名称

任务的名称,修改后将体现在工作流编排区域。

  • 必须以字母或数字开头
  • 只能由字母、数字、下划线和中划线组成
  • 长度范围为1~20个字符
  • 不能和同一工作流中的其他任务重名

超时(秒)

任务超时时间,即任务执行的最长时间。

支持设置0~300秒的超时时间,如果设置为0,则表示超时时间为默认值30秒。

算子提供方

函数模板的提供方。

错误处理

可定义不同类型错误发生时的重试次数、重试间隔,以及重试失败后跳转到的目标任务。

错误类型包括:匹配所有、执行失败、权限不合法、参数不合法、函数不存在、请求太频繁、函数不可用、函数异常

动态参数

attributes

选择希望获取的属性列表。

人脸搜索

模板作用:在已有的人脸库中,查询与目标人脸相似的一张或者多张人脸,并返回相应的置信度。该模板实际调用的是FRS服务的人脸搜索接口。

表4 人脸搜索属性配置说明

属性类别

参数名称

参数说明

基本属性

名称

任务的名称,修改后将体现在工作流编排区域。

  • 必须以字母或数字开头
  • 只能由字母、数字、下划线和中划线组成
  • 长度范围为1~20个字符
  • 不能和同一工作流中的其他任务重名

超时(秒)

任务超时时间,即任务执行的最长时间。

支持设置0~300秒的超时时间,如果设置为0,则表示超时时间为默认值30秒。

算子提供方

函数模板的提供方。

错误处理

可定义不同类型错误发生时的重试次数、重试间隔,以及重试失败后跳转到的目标任务。

错误类型包括:匹配所有、执行失败、权限不合法、参数不合法、函数不存在、请求太频繁、函数不可用、函数异常

动态参数

face_set_name

人脸库名称。

return_fields

指定返回的自定义字段。

数组类型参数必须以前括号([)开头,以后括号(])结尾,值之间用英文逗号(,)分隔。

top_n

返回查询到的最相似的N张人脸,N默认为10。

threshold

人脸相似度阈值,低于这个阈值则不返回,取值范围0~1,一般情况下建议取值0.93,默认为0。

圆角剪切

模板作用:指定圆角大小将图片剪切为圆角矩形。支持通过圆角半径大小和水平垂直大小两种方式设置。

表5 圆角剪切参数

属性类别

参数名称

参数说明

基本属性

名称

任务的名称,修改后将体现在工作流编排区域。

  • 必须以字母或数字开头
  • 只能由字母、数字、下划线和中划线组成
  • 长度范围为1~20个字符
  • 不能和同一工作流中的其他任务重名

超时(秒)

任务超时时间,即任务执行的最长时间。

支持设置0~300秒的超时时间,如果设置为0,则表示超时时间为默认值30秒。

算子提供方

函数模板的提供方。

错误处理

可定义不同类型错误发生时的重试次数、重试间隔,以及重试失败后跳转到的目标任务。

错误类型包括:匹配所有、执行失败、权限不合法、参数不合法、函数不存在、请求太频繁、函数不可用、函数异常

动态参数

crop_r

将图片切出圆角,指定圆角的半径,水平和垂直的值相同,可以使用像素数(如200)或百分比(如25p)。

像素数取值范围为[1,4096],当像素数大于原图最小边的一半时,取最小边的二分之一。

百分比取值范围为[1p,50p]。

不能与rx和ry参数同时使用。

crop_rx

圆角水平大小的参数,可以使用像素数(如200)或百分比(如25p)。

像素数取值范围为[1,4096],当像素数大于原图最小边的一半时,取最小边的二分之一。

百分比取值范围为[1p,50p]。

需要与ry同时使用。

crop_ry

圆角垂直大小的参数,可以使用像素数(如200)或百分比(如25p)。

像素数取值范围为[1,4096],当像素数大于原图最小边的一半时,取最小边的二分之一。

百分比取值范围为[1p,50p]。

需要与rx同时使用。

crop_source_path

输出路径是否保持原路径。true,输出路径为:output/原路径;false,输出路径为:output。

crop_outbucket

图片处理输出桶

普通裁剪

模板作用:可以设置图片上的任意一点为起始点,根据指定宽高进行图片剪切,剪切后的图片为矩形。

表6 普通剪切

属性类别

参数名称

参数说明

基本属性

名称

任务的名称,修改后将体现在工作流编排区域。

  • 必须以字母或数字开头
  • 只能由字母、数字、下划线和中划线组成
  • 长度范围为1~20个字符
  • 不能和同一工作流中的其他任务重名

超时(秒)

任务超时时间,即任务执行的最长时间。

支持设置0~300秒的超时时间,如果设置为0,则表示超时时间为默认值30秒。

算子提供方

函数模板的提供方。

错误处理

可定义不同类型错误发生时的重试次数、重试间隔,以及重试失败后跳转到的目标任务。

错误类型包括:匹配所有、执行失败、权限不合法、参数不合法、函数不存在、请求太频繁、函数不可用、函数异常

动态参数

crop_g

表示剪切起始原点位置。取值为tl、top、tr、left、center、right、bl、bottom和br,共9个取值。

crop_h

剪切的高度,取值范围为[0,图片高度]。

crop_w

剪切的宽度,取值范围为[0,图片宽度]。

crop_x

表示剪切起始点的横坐标,默认左上角为原点。取值范围为[0,图片边界]。

crop_y

表示剪切起始点的纵坐标,默认左上角为原点。取值范围为[0,图片边界]。

crop_source_path

输出路径是否保持原路径。true,输出路径为:output/原路径;false,输出路径为:output

crop_outbucket

图片处理输出桶

索引剪切

模板作用:以图片左上角顶点为起始点,设宽为x轴,高为y轴。根据指定长度进行等长剪切,根据指定索引取出剪切后区域。

表7 索引剪切

属性类别

参数名称

参数说明

基本属性

名称

任务的名称,修改后将体现在工作流编排区域。

  • 必须以字母或数字开头
  • 只能由字母、数字、下划线和中划线组成
  • 长度范围为1~20个字符
  • 不能和同一工作流中的其他任务重名

超时(秒)

任务超时时间,即任务执行的最长时间。

支持设置0~300秒的超时时间,如果设置为0,则表示超时时间为默认值30秒。

算子提供方

函数模板的提供方。

错误处理

可定义不同类型错误发生时的重试次数、重试间隔,以及重试失败后跳转到的目标任务。

错误类型包括:匹配所有、执行失败、权限不合法、参数不合法、函数不存在、请求太频繁、函数不可用、函数异常

动态参数

crop_i

若剪切后一共有n块,则i的取值范围为[0,n-1]。0表示第一块,超过最大的块数则返回原图。

crop_x

水平剪切的每块图片长度。取值范围为[1,图片宽度]。x和y参数只能任选其一。

crop_y

垂直剪切的每块图片长度。取值范围为[1,图片高度]。

x和y参数只能任选其一。

crop_source_path

输出路径是否保持原路径。true,输出路径为:output/原路径;false,输出路径为:output

crop_outbucket

图片处理输出桶

图片水印

模板作用:对添加水印的图片进行预处理操作,包括设置缩略、旋转图片和剪切图片,但不支持剪切为内切圆。

表8 图片水印

属性类别

参数名称

参数说明

基本属性

名称

任务的名称,修改后将体现在工作流编排区域。

  • 必须以字母或数字开头
  • 只能由字母、数字、下划线和中划线组成
  • 长度范围为1~20个字符
  • 不能和同一工作流中的其他任务重名

超时(秒)

任务超时时间,即任务执行的最长时间。

支持设置0~300秒的超时时间,如果设置为0,则表示超时时间为默认值30秒。

算子提供方

函数模板的提供方。

错误处理

可定义不同类型错误发生时的重试次数、重试间隔,以及重试失败后跳转到的目标任务。

错误类型包括:匹配所有、执行失败、权限不合法、参数不合法、函数不存在、请求太频繁、函数不可用、函数异常

动态参数

iwm_g

可选参数,表示水印处于图片的位置。取值为tl、top、tr、left、center、right、bl、bottom和br,共9个取值。默认值为tl。

iwm_x

可选参数,表示距离图片边缘的水平距离,默认左上角为原点。取值范围为[0,4096]。默认值为10。单位为像素(px)。

iwm_y

可选参数,表示距离图片边缘的垂直距离,默认左上角为原点。取值范围为[0,4096]。默认值为10。单位为像素(px)。

iwm_voffset

可选参数,表示水印距离图片水平中线的垂直偏移方向。可以使水印根据中线往上或往下偏移。取值范围为[-1000,1000]。默认值为0。单位为像素(px)。

当g取值为left、center、right才有意义,即位置为左中、正中、右中才有意义。

iwm_align

可选参数,水印文字和图片的对齐方式。取值为0、1或2。默认值为0。

  • 0:表示上对齐。
  • 1:表示中对齐。
  • 2:表示下对齐。

iwm_order

可选参数,水印文字和图片的前后顺序。取值为0或1。默认值为0。

  • 0:表示图片在前面。
  • 1:表示文字在前面。

iwm_t

可选参数,文字或图片水印的透明度。取值范围为[0,100]。默认值为100,100%表示不透明。

iwm_interval

可选参数,表示文字和图片的间距。取值范围为[0,1000]。

iwm_image

水印图路径,添加图片水印时的必选参数。

图片水印地址为:bucketName/objectName(必须编码)或bucketName/objectName?x-image-process=image/command(必须编码)

须知:

内容必须是URL安全base64编码。 encodedObject = url_safe_base64_encode(object)。如object为“panda.png”, 编码过后的内容为“cGFuZGEucG5n”。

iwm_P

水印图片尺寸,大写的P,表示将水印图片按原图(指被添加水印的图片)比例百分比P进行缩放。取值范围为[1,100]。

须知:

此处resize操作只支持大写P参数,不支持小写p参数。如需调整水印图片的大小,请参照设置缩略(除小p参数之外)。

iwm_source_path

输出路径是否保持原路径。true,输出路径为:output/原路径;false,输出路径为:output

iwm_outbucket

图片处理输出桶

文字水印

模板作用:对添加水印的图片进行预处理操作,包括设置缩略、旋转图片和剪切图片,但不支持剪切为内切圆。

表9 文字水印

属性类别

参数名称

参数说明

基本属性

名称

任务的名称,修改后将体现在工作流编排区域。

  • 必须以字母或数字开头
  • 只能由字母、数字、下划线和中划线组成
  • 长度范围为1~20个字符
  • 不能和同一工作流中的其他任务重名

超时(秒)

任务超时时间,即任务执行的最长时间。

支持设置0~300秒的超时时间,如果设置为0,则表示超时时间为默认值30秒。

算子提供方

函数模板的提供方。

错误处理

可定义不同类型错误发生时的重试次数、重试间隔,以及重试失败后跳转到的目标任务。

错误类型包括:匹配所有、执行失败、权限不合法、参数不合法、函数不存在、请求太频繁、函数不可用、函数异常

动态参数

twm_g

可选参数,表示水印处于图片的位置。取值为tl、top、tr、left、center、right、bl、bottom和br,共9个取值。默认值为tl。

twm_x

可选参数,表示距离图片边缘的水平距离,默认左上角为原点。取值范围为[0,4096]。默认值为10。单位为像素(px)。

twm_y

可选参数,表示距离图片边缘的垂直距离,默认左上角为原点。取值范围为[0,4096]。默认值为10。单位为像素(px)。

twm_voffset

可选参数,表示水印距离图片水平中线的垂直偏移方向。可以使水印根据中线往上或往下偏移。取值范围为[-1000,1000]。默认值为0。单位为像素(px)。

当g取值为left、center、right才有意义,即位置为左中、正中、右中才有意义。

twm_align

可选参数,水印文字和图片的对齐方式。取值为0、1或2。默认值为0。

  • 0:表示上对齐。
  • 1:表示中对齐。
  • 2:表示下对齐。

twm_order

可选参数,水印文字和图片的前后顺序。取值为0或1。默认值为0。

  • 0:表示图片在前面。
  • 1:表示文字在前面。

twm_t

可选参数,文字或图片水印的透明度。取值范围为[0,100]。默认值为100,100%表示不透明。

twm_interval

可选参数,表示文字和图片的间距。取值范围为[0,1000]。

twm_text

添加文字水印时的必选参数。

须知:

必须是URL安全base64编码。encodeText = url_safe_base64_encode(fontText),最大长度为64个字符(支持最多16个中文字符)。

twm_size

可选参数,表示文字水印的文字大小。取值范围为(0,1000]。默认值为40。

twm_type

可选参数,表示文字水印的文字类型。默认值为wqy-zenhei(文泉驿正黑,编码后的值:d3F5LXplbmhlaQ)。

须知:

必须是URL安全base64编码。encodeText = url_safe_base64_encode(fontType)。

twm_color

可选参数,表示文字水印的文字颜色。

格式为六位十六进制颜色码,取值为000000到FFFFFF,默认值为黑色。

twm_shadow

可选参数,表示文字水印的阴影透明度。取值范围为(0,100]。

twm_fill

可选参数,表示水印的铺满效果。取值为0或1。

  • 0:无效果。
  • 1:铺满。

twm_rotate

可选参数,表示文字水印的按顺时针旋转的角度。取值范围为(0,360)。

twm_source_path

输出路径是否保持原路径。true,输出路径为:output/原路径;false,输出路径为:output。

twm_outbucket

图片处理输出桶。

缩略图

模板作用:通过resize操作能够使图片按照一定规则进行缩放,支持按照指定宽高和比例进行缩放。

表10 缩略图设置

属性类别

参数名称

参数说明

基本属性

名称

任务的名称,修改后将体现在工作流编排区域。

  • 必须以字母或数字开头
  • 只能由字母、数字、下划线和中划线组成
  • 长度范围为1~20个字符
  • 不能和同一工作流中的其他任务重名

超时(秒)

任务超时时间,即任务执行的最长时间。

支持设置0~300秒的超时时间,如果设置为0,则表示超时时间为默认值30秒。

算子提供方

函数模板的提供方。

错误处理

可定义不同类型错误发生时的重试次数、重试间隔,以及重试失败后跳转到的目标任务。

错误类型包括:匹配所有、执行失败、权限不合法、参数不合法、函数不存在、请求太频繁、函数不可用、函数异常

动态参数

resize_m

设置缩略的类型。取值为lfit、mfit、fill、pad和fixed,默认值为lfit。

  • lfit:指定一个w和h的矩形,将图片进行等比缩放,取在矩形内最大的图片。
  • mfit:指定一个w和h的矩形,将图片进行等比缩放,取在矩形延伸区域的最小图片。
  • fill:指定一个w和h的矩形,将图片进行等比缩放,取在延伸区域的最小图片,并进行居中剪切。即将mfit缩略类型的图片进行居中剪裁。
  • pad:指定一个w和h的矩形,将图片进行等比缩放,取在矩形内最大的图片,并在矩形空白处进行颜色填充。即lfit缩略类型的图片在矩形空白处进行颜色填充。
  • fixed:强制按照固定的宽高进行缩略。

resize_p

等比例缩放的倍数百分比。使用参数p时,无法使用其它参数。取值范围为[1,1000]。当取值为:

  • <100:缩小。
  • =100:保持原图大小。
  • >100:放大。

resize_h

目标缩略图的高度。取值为[1,4096]。

resize_w

目标缩略图的宽度。取值为[1,4096]。

resize_l

指定目标缩略图的最长边。取值为[1, 4096]。

长边为指定的值,短边按照比例缩放。

resize_s

指定目标缩略图的最短边。取值为[1, 4096]。

短边为指定的值,长边按照比例缩放。

resize_color

填充的颜色。选择pad(缩略后填充)模式时可以使用。

格式为十六进制颜色码,取值为000000到FFFFFF,默认值为白色。

resize_limit

是否在目标缩略图比原图大时进行限制放大。取值为0或1,默认值为1。

  • 0:不进行限制。
  • 1:进行限制。

iwm_path

输出路径是否保持原路径。true,输出路径为:output/原路径;false,输出路径为:output

iwm_bucket

图片处理输出桶

内切圆裁剪

模板作用:以图片的中心为圆心,根据指定的半径进行图片剪切,剪切后的图片为圆形。

表11 内切圆裁剪

属性类别

参数名称

参数说明

基本属性

名称

任务的名称,修改后将体现在工作流编排区域。

  • 必须以字母或数字开头
  • 只能由字母、数字、下划线和中划线组成
  • 长度范围为1~20个字符
  • 不能和同一工作流中的其他任务重名

超时(秒)

任务超时时间,即任务执行的最长时间。

支持设置0~300秒的超时时间,如果设置为0,则表示超时时间为默认值30秒。

算子提供方

函数模板的提供方。

错误处理

可定义不同类型错误发生时的重试次数、重试间隔,以及重试失败后跳转到的目标任务。

错误类型包括:匹配所有、执行失败、权限不合法、参数不合法、函数不存在、请求太频繁、函数不可用、函数异常

动态参数

crop_ir

图片剪切的圆形半径,取值范围为[0,图片最短边的一半]。

crop_path

输出路径是否保持原路径。true,输出路径为:output/原路径;false,输出路径为:output

crop_bucket

图片处理输出桶

自适应旋转

模板作用:设置自适应方向,带有方向参数的图片会先根据方向参数信息进行自动旋转。

表12 自适应旋转

属性类别

参数名称

参数说明

基本属性

名称

任务的名称,修改后将体现在工作流编排区域。

  • 必须以字母或数字开头
  • 只能由字母、数字、下划线和中划线组成
  • 长度范围为1~20个字符
  • 不能和同一工作流中的其他任务重名

超时(秒)

任务超时时间,即任务执行的最长时间。

支持设置0~300秒的超时时间,如果设置为0,则表示超时时间为默认值30秒。

算子提供方

函数模板的提供方。

错误处理

可定义不同类型错误发生时的重试次数、重试间隔,以及重试失败后跳转到的目标任务。

错误类型包括:匹配所有、执行失败、权限不合法、参数不合法、函数不存在、请求太频繁、函数不可用、函数异常

动态参数

rotate_value

按照顺时针旋转的角度,取值范围为[0,360]。

默认值为0,0表示不旋转。数值越大,图片按顺时针方向旋转的角度越大。

autorate_source_path

输出路径是否保持原路径。true,输出路径为:output/原路径;false,输出路径为:output。

autoratote_outbucket

图片处理输出桶。

autoratote_outpath

图片处理输出路径。

基础旋转

模板作用:对图片进行旋转设置后,图片将会按顺时针方向进行旋转。

表13 基础旋转

属性类别

参数名称

参数说明

基本属性

名称

任务的名称,修改后将体现在工作流编排区域。

  • 必须以字母或数字开头
  • 只能由字母、数字、下划线和中划线组成
  • 长度范围为1~20个字符
  • 不能和同一工作流中的其他任务重名

超时(秒)

任务超时时间,即任务执行的最长时间。

支持设置0~300秒的超时时间,如果设置为0,则表示超时时间为默认值30秒。

算子提供方

函数模板的提供方。

错误处理

可定义不同类型错误发生时的重试次数、重试间隔,以及重试失败后跳转到的目标任务。

错误类型包括:匹配所有、执行失败、权限不合法、参数不合法、函数不存在、请求太频繁、函数不可用、函数异常

动态参数

rotate_value

按照顺时针旋转的角度,取值范围为[0,360]。

默认值为0,0表示不旋转。数值越大,图片按顺时针方向旋转的角度越大。

rotate_source_path

输出路径是否保持原路径。true,输出路径为:output/原路径;false,输出路径为:output。

rotate_outbucket

图片处理输出桶。

rotate_outpath

图片处理输出路径。

质量变换

模板作用:可以对输出格式为jpg的图片进行图片压缩,不使用压缩则可能会使图片占用的空间变大。

表14 质量变换

属性类别

参数名称

参数说明

基本属性

名称

任务的名称,修改后将体现在工作流编排区域。

  • 必须以字母或数字开头
  • 只能由字母、数字、下划线和中划线组成
  • 长度范围为1~20个字符
  • 不能和同一工作流中的其他任务重名

超时(秒)

任务超时时间,即任务执行的最长时间。

支持设置0~300秒的超时时间,如果设置为0,则表示超时时间为默认值30秒。

算子提供方

函数模板的提供方。

错误处理

可定义不同类型错误发生时的重试次数、重试间隔,以及重试失败后跳转到的目标任务。

错误类型包括:匹配所有、执行失败、权限不合法、参数不合法、函数不存在、请求太频繁、函数不可用、函数异常

动态参数

quality_q

图片的相对质量,即将图片按照原图的q%进行压缩。取值范围为[1,100]。

压缩公式:目标图质量=原图质量 * q%

例如:如果原图质量为100%,将图片压缩至80%的相对质量,则目标图片的质量为80%。如果原图的质量为80%,将图片压缩至80%的相对质量,则目标图片的质量为64%。

quality_Q

图片的绝对质量,即直接将图片压缩为Q%,与原图不存在相对关系,不依赖于原图。取值范围为[1,100]。

压缩公式:

  • 原图质量 > Q%,目标图质量 = Q%
  • 原图质量 = Q%,目标图质量 = 原图质量 = Q%
  • 原图质量 < Q%,目标图质量 = 原图质量

例如:如果原图质量为100%,将图片压缩至80%的绝对质量,则目标图片的质量为80%。如果原图质量为70%,将图片压缩至80%的绝对质量,则目标图片的质量为70%。

quality_path

输出路径是否保持原路径。true,输出路径为:output/原路径;false,输出路径为:output

quality_bucket

图片处理输出桶

格式转换

模板作用:可以将原图转换为支持的图片格式。

  • 支持的原图格式:jpg、jpeg、png、bmp、webp、gif、tiff。
  • 支持输出的目标图格式:jpg、png、bmp、webp。
表15 格式转换

属性类别

参数名称

参数说明

基本属性

名称

任务的名称,修改后将体现在工作流编排区域。

  • 必须以字母或数字开头
  • 只能由字母、数字、下划线和中划线组成
  • 长度范围为1~20个字符
  • 不能和同一工作流中的其他任务重名

超时(秒)

任务超时时间,即任务执行的最长时间。

支持设置0~300秒的超时时间,如果设置为0,则表示超时时间为默认值30秒。

算子提供方

函数模板的提供方。

错误处理

可定义不同类型错误发生时的重试次数、重试间隔,以及重试失败后跳转到的目标任务。

错误类型包括:匹配所有、执行失败、权限不合法、参数不合法、函数不存在、请求太频繁、函数不可用、函数异常

动态参数

format

将原图转换为支持的图片格式

format_path

输出路径是否保持原路径。true,输出路径为:output/原路径;false,输出路径为:output

format_bucket

图片处理输出桶

图像标签

模板作用:能准确识别自然图片中数百种场景、上千种通用物体及其属性。让智能相册管理等功能更加直观。该模板实际调用的是Image服务的图像标签接口。

表16 图像标签属性配置说明

属性类别

参数名称

参数说明

基本属性

名称

任务的名称,修改后将体现在工作流编排区域。

  • 必须以字母或数字开头
  • 只能由字母、数字、下划线和中划线组成
  • 长度范围为1~20个字符
  • 不能和同一工作流中的其他任务重名

超时(秒)

任务超时时间,即任务执行的最长时间。

支持设置0~300秒的超时时间,如果设置为0,则表示超时时间为默认值30秒。

算子提供方

函数模板的提供方。

错误处理

可定义不同类型错误发生时的重试次数、重试间隔,以及重试失败后跳转到的目标任务。

错误类型包括:匹配所有、执行失败、权限不合法、参数不合法、函数不存在、请求太频繁、函数不可用、函数异常

动态参数

threshold

置信度的阈值(0~100),输入非该范围内值算法即取默认值。默认值:0。

limit

最多返回的tag数,默认值:30。

language

中文:返回标签的语言类型为中文。

英文:返回标签的语言类型为英文。

视频解析

模板作用:用于新建视频解析任务,以解析视频元数据。该模板实际调用的是MPC服务的新建视频解析任务接口。

表17 视频解析属性配置说明

属性类别

参数名称

参数说明

基本属性

名称

任务的名称,修改后将体现在工作流编排区域。

  • 必须以字母或数字开头
  • 只能由字母、数字、下划线和中划线组成
  • 长度范围为1~20个字符
  • 不能和同一工作流中的其他任务重名

超时(秒)

任务超时时间,即任务执行的最长时间。

支持设置0~300秒的超时时间,如果设置为0,则表示超时时间为默认值30秒。

算子提供方

函数模板的提供方。

错误处理

可定义不同类型错误发生时的重试次数、重试间隔,以及重试失败后跳转到的目标任务。

错误类型包括:匹配所有、执行失败、权限不合法、参数不合法、函数不存在、请求太频繁、函数不可用、函数异常

动态参数

sync

视频解析处理模式。

  • 排队处理:查询后仅返回任务ID,还需进一步调用查询视频解析任务接口才能获取到视频元数据。
  • 同步处理:查询后将直接返回视频元数据。

bucket

视频解析输出桶,用于保存解析后的视频。

输出桶需要和DWR工作流在同一区域,工作流所属区域为创建工作流的桶所属区域。例如工作流A是在桶A中创建的,则桶A的区域即为工作流A的区域。

outpath

视频解析输出桶中存放视频的具体目录。

例如:输入abc或abc/,均表示视频存放在abc文件夹下,如果文件夹不存在,会自动新建。输出路径为空表示存放在桶的根目录。

抽帧截图

模板作用:用于新建视频截图任务。该模板实际调用的是MPC服务的新建截图任务接口。

表18 抽帧截图属性配置说明

属性类别

参数名称

参数说明

基本属性

名称

任务的名称,修改后将体现在工作流编排区域。

  • 必须以字母或数字开头
  • 只能由字母、数字、下划线和中划线组成
  • 长度范围为1~20个字符
  • 不能和同一工作流中的其他任务重名

超时(秒)

任务超时时间,即任务执行的最长时间。

支持设置0~300秒的超时时间,如果设置为0,则表示超时时间为默认值30秒。

算子提供方

函数模板的提供方。

错误处理

可定义不同类型错误发生时的重试次数、重试间隔,以及重试失败后跳转到的目标任务。

错误类型包括:匹配所有、执行失败、权限不合法、参数不合法、函数不存在、请求太频繁、函数不可用、函数异常

动态参数

bucket

抽帧截图输出桶,用于保存视频截图。

输出桶需要和工作流在同一区域,工作流所属区域为创建工作流的桶所属区域。例如工作流A是在桶A中创建的,则桶A的区域即为工作流A的区域。

output

抽帧截图输出桶中存放截图的具体目录。

例如:输入abc或abc/,均表示视频存放在abc文件夹下,如果文件夹不存在,会自动新建。输出路径为空表示存放在桶的根目录。

tar

是否压缩抽帧图片生成tar包。

sync

是否同步处理,同步处理是指不下载全部文件,快速定位到截图位置进行截图。

type

采样类型,可选择如下类型:

  • 根据视频时长的百分比间隔采样
  • 根据时间间隔采样截图
  • 指定时间点截图

output_filename

截图输出文件名。

  • 如果只抽一张图(即:按DOTS方式,指定1个时间点)则按该指定文件名输出图片。
  • 如果抽多张图(即:按DOTS方式指定多个时间点或按TIME间隔截图)则输出图片名在该指定文件名基础上再增加时间点(示例:output_filename_10.jpg)。
  • 如果指定了压缩抽帧图片生成tar包,则tar包按该指定文件名输出。

format

截图文件格式。

目前支持的取值为:jpg格式

width

截图图片宽度。

取值范围:(96,3840]

单位:px

height

截图图片高度。

取值范围:(96,2160]

单位:px

maxlen

截图最长边的尺寸。宽边尺寸按照该尺寸与原始视频像素等比缩放计算。

取值范围:[240,3840]

单位:像素

说明:

该参数和thumb_samp_width/thumb_samp_height选择使用,以thumb_samp_width/thumb_samp_height优先,若thumb_samp_width/thumb_samp_height都不等于0,则图片尺寸按thumb_samp_width/thumb_samp_height得出;反之,则图片尺寸按thumb_samp_maxlen得出。

ratio

截图纵横比。

percent

根据视频时长百分比间隔采样时的百分比值。

dots

指定时间截图时的时间点数组。

数组类型参数必须以前括号([)开头,以后括号(])结尾,值之间用英文逗号(,)分隔。

time

采样截图的时间间隔值。

单位:秒

start

采样类型为“TIME”模式的开始时间,和thumb_samp_time配合使用。

单位:秒

duration

采样类型为“TIME”模式的持续时间,和thumb_samp_time、thumb_samp_start配合使用。表示从视频文件的第“thumb_samp_start”开始,持续时间为“thumb_samp_duration”,每间隔“thumb_samp_time”生成一张截图。

取值范围:[数字,ToEND]。“ToEND”表示持续到视频结束。

单位:秒

说明:

“thumb_samp_duration”必须大于等0,若设置为0,则截图持续时间从“thumb_samp_start”到视频结束。

媒资转码

模板作用:执行MPC服务的转码任务对视频进行转码,并在转码过程中压制水印、内容质检、视频截图等。该模板实际调用的是MPC服务的新建转码任务接口。

表19 媒资转码属性配置说明

属性类别

参数名称

参数说明

基本属性

名称

任务的名称,修改后将体现在工作流编排区域。

  • 必须以字母或数字开头
  • 只能由字母、数字、下划线和中划线组成
  • 长度范围为1~20个字符
  • 不能和同一工作流中的其他任务重名

超时(秒)

任务超时时间,即任务执行的最长时间。

支持设置0~300秒的超时时间,如果设置为0,则表示超时时间为默认值30秒。

算子提供方

函数模板的提供方。

错误处理

可定义不同类型错误发生时的重试次数、重试间隔,以及重试失败后跳转到的目标任务。

错误类型包括:匹配所有、执行失败、权限不合法、参数不合法、函数不存在、请求太频繁、函数不可用、函数异常

动态参数

(基本参数)

bucket

媒资转码输出桶,用于保存转码后的视频文件。

输出桶需要和工作流在同一区域,工作流所属区域为创建工作流的桶所属区域。例如工作流A是在桶A中创建的,则桶A的区域即为工作流A的区域。

output

媒资转码输出桶中存放转码后视频的具体目录。

例如:输入abc或abc/,均表示视频存放在abc文件夹下,如果文件夹不存在,会自动新建。输出路径为空表示存放在桶的根目录。

trans_tid

转码模板ID,数组,每一路转码输出对应一个转码配置模板ID,最多支持9个模板ID。

数组类型参数必须以前括号([)开头,以后括号(])结尾,值之间用英文逗号(,)分隔。

动态参数

(字幕参数)

subtitle_type

媒资转码字幕类型。

bucket

存放字幕文件的OBS桶。

file_name

字幕对象名,即字幕文件。

动态参数

(图片水印设置)

bucket

存放水印图片的OBS桶。

file_name

水印图片对象名,即水印文件。

dx

水印图片起点相对输出视频顶点的水平偏移量。

设置方法有如下两种:

  • 整数型:表示图片起点水平偏移视频顶点的像素值,单位px。取值范围:[0,4096]
  • 小数型:表示图片起点相对于视频分辨率宽的水平偏移比率。取值范围:(0,1),支持4位小数,如0.9999,超出部分系统自动丢弃。

示例:输出视频分辨率宽1920,设置“dx”为“0.1”,“referpos”为“TopRight”(右上角),则水印图片右上角到视频右顶点在水平方向上偏移距离为192。

dy

水印图片起点相对输出视频顶点的垂直偏移量。

设置方法有如下两种:

  • 整数型:表示图片起点垂直偏移视频顶点的像素值,单位px。取值范围:[0,4096]
  • 小数型:表示图片起点相对于视频分辨率高的垂直偏移比率。取值范围:(0,1),支持4位小数,如0.9999,超出部分系统自动丢弃。

示例:输出视频分辨率高1080,设置“dy”为“0.1”,“referpos”为“TopRight”(右上角),则水印图片右上角到视频右顶点在垂直方向上的偏移距离为108。

referpos

水印位置。支持如下位置:

  • 右上角
  • 左上角
  • 右下角
  • 左下角

timeline_start

水印开始时间,与trans_iwm_tduration配合使用。

取值范围:数字

单位:秒

timeline_duration

水印持续时间,与“trans_iwm_tstart”配合使用。

取值范围:[数字,ToEND]。“ToEND”表示持续到视频结束。

image_process

水印图片处理方式。支持如下方式:

  • 简单缩放
  • 图片变灰
  • 透明化

width

水印图片宽度,值有两种形式:

  • 整数型代水印图片宽的像素值,范围[8,4096],单位px。
  • 小数型代表相对输出视频分辨率宽的比率,范围(0,1),支持4位小数,如0.9999,超出部分系统自动丢弃。

height

水印图片高度,值有两种形式:

  • 整数型代表水印图片高的像素值,范围[8,4096],单位px。
  • 小数型代表相对输出视频分辨率高的比率,范围(0,1),支持4位小数,如0.9999,超出部分系统自动丢弃。

base

水印叠加母体,取值如下:

  • 叠加在输入片源
  • 叠加在转码输出文件

动态参数

(水印参数)

template_id

水印模板ID。可通过新建水印模板接口创建水印模板。

动态参数

(文字水印配置)

text_context

文字水印内容,内容需做Base64编码,此配置项不能为空

示例:若想添加文字水印“测试文字水印”,那么Content的值为:5rWL6K+V5paH5a2X5rC05Y2w

dx

文字水印起点相对输出视频顶点的水平偏移量。

设置方法有如下两种:

  • 整数型:表示文字起点水平偏移视频顶点的像素值,单位px。取值范围:[0,4096]
  • 小数型:表示文字起点相对于视频分辨率宽的水平偏移比率。取值范围:(0,1),支持4位小数,如0.9999,超出部分系统自动丢弃。

示例:输出视频分辨率宽1920,设置“dx”为“0.1”,“referpos”为“TopRight”(右上角),则文字水印右上角到视频右顶点在水平方向上偏移距离为192。

dy

文字水印起点相对输出视频顶点的垂直偏移量。

设置方法有如下两种:

  • 整数型:表示文字起点垂直偏移视频顶点的像素值,单位px。取值范围:[0,4096]
  • 小数型:表示文字起点相对于视频分辨率高的垂直偏移比率。取值范围:(0,1),支持4位小数,如0.9999,超出部分系统自动丢弃。

示例:输出视频分辨率高1080,设置“dy”为“0.1”,“referpos”为“TopRight”(右上角),则文字水印右上角到视频右顶点在垂直方向上的偏移距离为108。

referpos

文字水印位置。支持如下位置:

  • 右上角
  • 左上角
  • 右下角
  • 左下角

timeline_start

文字水印开始时间,与“trans_twm_tduration”配合使用。

取值范围:数字

单位:秒

timeline_duration

文字水印持续时间,与“trans_twm_tstart”配合使用。

取值范围:[数字,ToEND]。“ToEND”表示持续到视频结束。

base

文字水印叠加母体,取值如下:

  • 叠加在输入片源
  • 叠加在转码输出文件

font_name

文字水印文字字体名。当前支持的字体有

  • 方正黝黑
  • 微软雅黑

font_size

文字水印文字字体大小。

取值范围:[4, 120]

font_color

文字水印文字字体颜色。

DIS消息通知

模板作用:发送消息到您指定的DIS通道。该模板实际调用的是DIS服务的上传数据接口。

表20 DIS消息通知属性配置说明

属性类别

参数名称

参数说明

基本属性

名称

任务的名称,修改后将体现在工作流编排区域。

  • 必须以字母或数字开头
  • 只能由字母、数字、下划线和中划线组成
  • 长度范围为1~20个字符
  • 不能和同一工作流中的其他任务重名

超时(秒)

任务超时时间,即任务执行的最长时间。

支持设置0~300秒的超时时间,如果设置为0,则表示超时时间为默认值30秒。

算子提供方

函数模板的提供方。

错误处理

可定义不同类型错误发生时的重试次数、重试间隔,以及重试失败后跳转到的目标任务。

错误类型包括:匹配所有、执行失败、权限不合法、参数不合法、函数不存在、请求太频繁、函数不可用、函数异常

动态参数

stream_name

已创建的DIS通道名称。

partition_id

DIS通道分区的唯一标识符。

partition_key

数据将写入的DIS通道分区。

SMN消息通知

模板作用:可用于在执行某项任务后,向SMN主题的订阅者发送通知。您可以在工作流的任意位置添加SMN消息通知,将上一个函数的执行结果发送给订阅者。

表21 SMN消息通知属性配置说明

属性类别

参数名称

参数说明

基本属性

名称

任务的名称,修改后将体现在工作流编排区域。

  • 必须以字母或数字开头
  • 只能由字母、数字、下划线和中划线组成
  • 长度范围为1~20个字符
  • 不能和同一工作流中的其他任务重名

超时(秒)

任务超时时间,即任务执行的最长时间。

支持设置0~300秒的超时时间,如果设置为0,则表示超时时间为默认值30秒。

算子提供方

函数模板的提供方。

错误处理

可定义不同类型错误发生时的重试次数、重试间隔,以及重试失败后跳转到的目标任务。

错误类型包括:匹配所有、执行失败、权限不合法、参数不合法、函数不存在、请求太频繁、函数不可用、函数异常

动态参数

topic_urn

SMN topic唯一标识。选择已授权给OBS发布消息的SMN主题,以便向主题订阅者发送消息。SMN主题需通过SMN页面创建。

SMN服务的操作指导请参见《消息通知服务用户指南》中“创建主题”、“设置主题策略”和“订阅主题”章节的内容。

说明:

SMN主题配置成功后,请不要随意删除与OBS DWR工作流相关联的主题,也不要取消主题对OBS的授权。若与OBS DWR工作流相关联的主题被删除或取消该主题对OBS的授权,可能会导致对应主题的订阅者无法收到消息。

下拉列表中仅展示与DWR工作流同区域且同项目的SMN主题。工作流所属区域为创建工作流的桶所属区域。例如工作流A是在桶A中创建的,则桶A的区域即为工作流A的区域。

project_id

SMN topic主题名称,为发布消息的标题,给邮箱订阅者发送邮件时作为邮件主题。

事件延迟

模板作用:可用于控制工作流两个相邻任务间的等待时长,例如执行任务A后,规定等待一段时间再继续执行任务B。

表22 事件延迟属性配置说明

属性类别

参数名称

参数说明

基本属性

名称

任务的名称,修改后将体现在工作流编排区域。

  • 必须以字母或数字开头
  • 只能由字母、数字、下划线和中划线组成
  • 长度范围为1~20个字符
  • 不能和同一工作流中的其他任务重名

超时(秒)

执行下一任务前的等待时长,单位:秒。支持设置的范围为1~86400秒。

自定义

用户可自定义函数,满足不同场景的任务定制需求。

自定义函数属性配置说明见下表,另外需要遵循自定义函数开发规范。

表23 自定义函数属性配置说明

属性类别

参数名称

参数说明

基本属性

名称

任务的名称,修改后将体现在工作流编排区域。

  • 必须以字母或数字开头
  • 只能由字母、数字、下划线和中划线组成
  • 长度范围为1~20个字符
  • 不能和同一工作流中的其他任务重名

超时(秒)

任务超时时间,即任务执行的最长时间。

支持设置0~300秒的超时时间,如果设置为0,则表示超时时间为默认值30秒。

函数唯一标识

选择需要执行的FunctionGraph中的函数。函数需通过FunctionGraph页面创建。

FunctionGraph服务的操作指导请参见《函数工作流用户指南》中“创建并初始化函数”章节的内容。

下拉列表中仅展示与DWR工作流同区域且同项目的函数。工作流所属区域为创建工作流的桶所属区域。例如工作流A是在桶A中创建的,则桶A的区域即为工作流A的区域。

动态参数

若自定义函数中存在动态参数,可以指定动态参数的参数名和取值,作为函数的输入。

图片暗水印

图片暗水印指将水印以不可见的形式添加到图片中,既保证了水印不会影响图片美观性,又保证了图片的原创性。当图片被盗用后,您可对图片进行暗水印解码,验证版权归属。

表24 图片暗水印

属性类别

参数名称

参数说明

基本属性

名称

任务的名称,修改后将体现在工作流编排区域。

  • 必须以字母或数字开头
  • 只能由字母、数字、下划线和中划线组成
  • 长度范围为1~20个字符
  • 不能和同一工作流中的其他任务重名

超时(秒)

任务超时时间,即任务执行的最长时间。

支持设置0~300秒的超时时间,如果设置为0,则表示超时时间为默认值30秒。

算子提供方

函数模板的提供方。

错误处理

可定义不同类型错误发生时的重试次数、重试间隔,以及重试失败后跳转到的目标任务。

错误类型包括:匹配所有、执行失败、权限不合法、参数不合法、函数不存在、请求太频繁、函数不可用、函数异常

动态参数

image_watermark_path

作为图片盲水印文件的OBS路径,格式为obs://{bucket}/{object}。

  • bucket为和当前函数处于相同区域的OBS桶名称。
  • object为对象全路径名,支持jpg和png格式。

output_using_input

输出路径是否保持原路径。

  • true,输出路径为:output_path/原路径。
  • false,输出路径为:output_path。

output_bucket

嵌入水印后的图片输出的OBS桶名称,指定的OBS桶需和当前函数在相同区域项目下。

output_path

嵌入水印后的图片输出路径,与参数output_using_input结合使用。

相关文档