数据工坊 DWR-官方算子一览:媒资转码

时间:2025-02-12 14:54:13

媒资转码

模板作用:执行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

文字水印文字字体颜色。

support.huaweicloud.com/usermanual-dwr/dwr_03_0004.html