模板说明

最近更新时间:2021-01-04 14:37:13

查看PDF

模板说明

模板类型说明

媒体转码模板是以Json格式预先设定的一组或多组转码参数,用来指定实施转码之后的目标媒体文件的特性参数以及转码的处理方式,包括视频分辨率、码率、帧率以及加水印、截图等相关参数,客户使用媒体转码服务时均需事先定义好转码模板,然后再根据模板来执行相关任务。

根据转码任务类型的不同媒体转码模板分为以下四种类型:

  • avtrans:转码/转码拼接/格式转换/水印/切片
  • avsnapshot:单张截图
  • avinfo:音视频信息获取

公有参数说明

名称 类型 必填项 描述
Preset string 模板名称,由2~32位字母、数字、下划线组成
Description string 模板描述
PresetType string 模板类型,目前支持avtrans/avsample/avsnapshot/avinfo,媒体转码模板命名空间模板名+模板类型必须唯一
Param json object 模板详情参数集,用于设定具体的转码参数,不同类型的模板具有不同的Param参数形式

公有参数格式定义:

所有媒体转码模板具有统一的格式:

{
    "Preset": "mypreset",
    "Description": "demo",
    "PresetType": "avtrans",
    "Param":{
      ...
    }
}

四类模板Param详细说明

1. avtrans模板Param格式定义:

名称 类型 必填项 描述
f string 转码输出的容器格式(ContainerFormat),可选值:mp4,flv,hls,mpegts,mp3,adts,dash,gif。
AUDIO json object 指定输出文件音频流的参数,详见下方AUDIO参数详情
VIDEO json object 指定输出文件视频流的参数,详见下方VIDEO参数详情
LOGOS json array 往输出文件中加一张logo。
mulrate int Dash多码率转码开关, 0:关闭 1:开启,开启后支持dash多码率转码,仅适配mulAb(音频多码率)、mulVb(视频多码率)、mulRes(视频多分辨率)参数设定,音频多码率与视频多码率位置一一对应例如mulVb为 2m:1200k:800k,mulres为1920x1080:1280x720:600x360,那么2m与1920x1080即为映射关系

转码音频参数详情(AUDIO)

名称 类型 必填项 描述
ab string 音频码率,支持k表示,如:128k。取值范围 20000~320000
mulAb string 在mulrate=1情况下有效,音频多码率,格式:128k:64k:32k
ar string 音频采样频率,取值范围 8000~96000
an int 是否去除音频流, 0:不去除(默认);1:去除
acodec string 音频编码器,支持:aac(默认)、mp3、copy。设置copy时,请保证容器格式与codec兼容。当f输出格式为mp3时,acodec必须设置为mp3
profile string 音频编码预置,当acodec为aac时,范围aac_low、aac_he。默认逻辑:码率小于64k为aac_he,否则为aac_low,设置为aac_low采样率保持不变 设置为acc_he采样率会变小大约一半

转码视频参数详情(VIDEO)

名称 类型 必填项 描述
vr string 视频帧率,取值范围 [1,60]
vb string 视频码率,支持k、m 如:400k。取值范围 30000~50000000
vcodec string 视频编码器,支持:h264(默认)、h265
width int 视频分辨率宽,如果只指定任一,会按原视频宽高比缩放到指定值,需要在as=1情况下使用
height Int 视频分辨率高,如果只指定任一,会按原视频宽高比缩放到指定值,需要在as=1情况下使用
mulVb string mulrate=1时,必填 在mulrate=1情况下有效,视频多码率,支持k、m格式:2m:1200k:800k
mulRes string mulrate=1时,必填 在mulrate=1情况下有效,格式: 1920x1080:1280x720:600×360,视频多分辨率与多码率参数一一对应,支持按原比例等比缩放,自动计算另一边长格式为例如-1x360,待计算边长用-1替代
mulVr string mulrate=1时,必填 在mulrate=1情况下有效,格式: 24:23:30,视频帧率与视频分辨率、视频码率一一对应
shortSide int 设置输出视频短边,程序按照原始比例自动缩放。如果需要模板支持横竖屏视频自动判断转码,则设置该参数。该参数需要在as=1情况下使用
as int 是否按原比例进行缩放,取值范围 0:不自动缩放(默认);1:自动缩放
vn int 是否去除视频流,取值范围 0:不去除(默认);1:去除
intervalframes int 转gif等动态图时,指定抽帧间隔,单位为帧,不设默认不抽帧
loop int gif与webp循环次数,默认不循环
finaldelay int gif的loop间隔,单位为百分之一秒,比如500代表间隔为5s

转码水印参数详情(LOGOS)

名称 类型 必填项 描述
url string 必填,水印图片地址,需要ks3的内网地址。该pic必须是不需要签名就可以访问的,public。该pic必须是与转码服务在同一region,即转码源文件在上海bucket,pic也要在上海bucket。
offsetX int pic宽的偏移值,向右为正。可选值,默认把pic放在左上角,offsetX=10,offsetY=10。如果offsetX=-10,offsetY=10,则Pic放在视频右上角。
offsetY int pic高的偏移值,向下为正。可选值,默认把pic放在左上角,offsetX=10,offsetY=10。如果offsetX=-10,offsetY=10,则Pic放在视频右上角。
ss int 设置logo的进入时间,单位为秒。不设默认为0:从头开始
duration int 设置logo的显示持续时间,单位为秒。不设默认为0:持续到结束,video类型logo持续到video结束。
referPos(推荐设置) string 水印的位置,每个位置有对应的锚点,TopRight、TopLeft、BottomRight、BottomLeft、Top、Bottom、Left、Right、Center。默认TopLeft。
width string string类型,值有两种形式:整数型代水印图片宽的像素值,范围[8,4096],单位px;小数型代表相对输出视频分辨率宽/高的比率,范围(0,1],支持4位小数,如0.9999,超出部分系统自动丢弃。小数时可添加 *h 或 w 指定比率的参考是视频的宽或高,如 0.26h 表示占视频高的0.26。
height string 同上。
opacity string 不透明度设置,范围(0-1],值越大不透明度越高,1表示完全不透明。不设置默认为1。支持1位小数,比如0.8,超出部分自动丢弃。
loop int 动态logo轮询次数,目前只支持gif格式的水印,0为无限循环,不设置默认为0。

水印宽、高参数设置说明:

水印位置坐标说明:

logo_position.png

2.avsample模板Param格式定义:

**avsample模板支持处理截图视频格式包含(MP4,flv,m3u8,mov,wmv,avi,mpg,mpeg)**输出格式为根据dstobjectkey指定,支持jpg、png、默认为jpg

名称 类型 描述 必填项
width int 图片分辨率宽。如果只指定width/height任一,会按原比例缩放
height int 图片分辨率高。如果只指定width/height任一,会按原比例缩放
interval int 间隔,单位s

avsample模板的param示例如下:

{
	"width": xxx,
	"height": xxx,
	"interval": xxx,
	
}

3.avsnapshot模板Param格式定义:

**avsnapshot模板支持处理截图视频格式包含(MP4,flv,m3u8,mov,wmv,avi,mpg,mpeg)**输出格式为根据dstobjectkey指定,支持jpg、png,默认为jpg

名称 类型 必填项 描述
width int 图片分辨率宽。宽高必须全部设定,除非设置了shortSide,否则会按源分辨率生成截图
height int 图片分辨率高。宽高必须全部设定,除非设置了shortSide,否则会按源分辨率生成截图
shortSide int 设置输出截图短边,程序按照原始比例自动缩放。如果源视频既可能横屏,也可能竖屏,需要模板支持自动判断生成截图,则设置该参数。该参数优先级最高
ss string 设置截图的时间点,单位s

avsnapshot的param示例如下:

{
	"width": xxx,
	"height": xxx,
	"shortSide":360,
	"ss": "30"
}

4.avinfo模板Param格式定义:

{
    //avinfo无需参数
}

注:以上模板格式中,参数值均为示例值。

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

  • 内容不全,不深入
  • 内容更新不及时
  • 描述不清晰,比较混乱
  • 系统或功能太复杂,缺乏足够的引导
  • 内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈