更新时间: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结合使用。

相关文档