全部产品

Effect配置说明

素材效果Effect的具体结构与效果类型有关,本篇将按照不同的素材效果类型分别描述

Effect Type:Text 横幅文字

名称

类型

描述

X

Float

横幅文字左上角距离输出视频左上角的横向距离。注:支持百分比和像素两种形式。当取值为[0~0.9999]时,表示相对输出视频宽的占比。当取值为>=8的整数时,表示绝对像素。

Y

Float

横幅文字左上角距离输出视频左上角的纵向距离。注:支持百分比和像素两种形式。当取值为[0~0.9999]时,表示相对输出视频高的占比。当取值为>=8的整数时,表示绝对像素。

TimelineIn

Float

横幅文字出现在时间线的起始位置。单位:秒,精确到小数点后4位。如果TimelineIn不填,则会与对应Clip的TimelineIn保持一致

TimelineOut

Float

横幅文字出现在时间线的结束位置。单位:秒,精确到小数点后4位。如果TimelineOut不填,则会与对应Clip的TimelineOut保持一致

Content

String

横幅文字内容。

Font

String

横幅文字的字体。具体支持的字体参见:https://help.aliyun.com/document_detail/59950.html

FontSize

Int

横幅文字的字号。

FontColor

String

横幅文字的颜色,格式为#后跟16进制值。例如:#ffffff。

FontColorOpacity

String

横幅文字的透明度,表示文字的透明度,取值0-1。1为不透明,0为完全透明。

FontFace

FontFace

横幅文字的字体外观。

Effect Type:DeWatermark 模糊

名称

类型

描述

X

Float

模糊区域左上角距离输出视频左上角的横向距离。注:支持百分比和像素两种形式。当取值为[0~0.9999]时,表示相对输出视频宽的占比。当取值为>=8的整数时,表示绝对像素。

Y

Float

模糊区域左上角距离输出视频左上角的纵向距离。注:支持百分比和像素两种形式。当取值为[0~0.9999]时,表示相对输出视频高的占比。当取值为>=8的整数时,表示绝对像素。

Width

Float

模糊区域在输出视频中的宽度。注:支持百分比和像素两种形式。当取值为[0~0.9999]时,表示相对输出视频宽的占比。当取值为>=8的整数时,表示绝对像素。

Height

Float

模糊区域在输出视频中的高度。注:支持百分比和像素两种形式。当取值为[0~0.9999]时,表示相对输出视频高的占比。当取值为>=8的整数时,表示绝对像素。

TimelineIn

Float

模糊区域出现在时间线的起始位置。单位:秒,精确到小数点后4位。如果TimelineIn不填,则会与对应Clip的TimelineIn保持一致

TimelineOut

Float

模糊区域出现在时间线的结束位置。单位:秒,精确到小数点后4位。如果TimelineOut不填,则会与对应Clip的TimelineOut保持一致

Effect Type:Crop 裁剪

名称

类型

描述

X

Float

裁剪后保留的区域左上角距离输出视频左上角的横向距离。注:支持百分比和像素两种形式。当取值为[0~0.9999]时,表示相对输出视频宽的占比。当取值为>=8的整数时,表示绝对像素。

Y

Float

裁剪后保留的区域左上角距离输出视频左上角的纵向距离。注:支持百分比和像素两种形式。当取值为[0~0.9999]时,表示相对输出视频高的占比。当取值为>=8的整数时,表示绝对像素。

Width

Float

裁剪后保留的区域在输出视频中的宽度。注:支持百分比和像素两种形式。当取值为[0~0.9999]时,表示相对输出视频宽的占比。当取值为>=8的整数时,表示绝对像素。

Height

Float

裁剪后保留的区域在输出视频中的高度。注:支持百分比和像素两种形式。当取值为[0~0.9999]时,表示相对输出视频高的占比。当取值为>=8的整数时,表示绝对像素。

Effect Type:Scale 缩放

注:当未指定Scale效果,且素材画面宽高与输出视频画面不一致时,自动将素材画面缩放到宽或高与输出画面一致,另2边自动贴上下黑边或左右黑边,素材画面居中

名称

类型

描述

Width

Float

缩放后保留的区域在输出视频中的宽度。注:支持百分比和像素两种形式。当取值为[0~0.9999]时,表示相对输出视频宽的占比。当取值为>=1的整数时,表示绝对像素。

Height

Float

缩放后保留的区域在输出视频中的高度。注:支持百分比和像素两种形式。当取值为[0~0.9999]时,表示相对输出视频高的占比。当取值为>=1的整数时,表示绝对像素。

Effect Type:Pad 贴边

注:当未指定Pad效果,且素材画面比例与输出视频画面比例不符时,自动将素材画面缩放到宽或高与输出画面一致,另2边自动贴上下黑边或左右黑边,素材画面居中

名称

类型

描述

Left

Float

素材画面左边输出视频左边的距离。注:支持百分比和像素两种形式。当取值为[0~0.9999]时,表示相对输出视频宽的占比。当取值为>=1的整数时,表示绝对像素。

Right

Float

素材画面右边输出视频右边的距离。注:支持百分比和像素两种形式。当取值为[0~0.9999]时,表示相对输出视频宽的占比。当取值为>=1的整数时,表示绝对像素。

Top

Float

素材画面上边输出视频上边的距离。注:支持百分比和像素两种形式。当取值为[0~0.9999]时,表示相对输出视频高的占比。当取值为>=1的整数时,表示绝对像素。

Bottom

Float

素材画面下边输出视频下边的距离。注:支持百分比和像素两种形式。当取值为[0~0.9999]时,表示相对输出视频高的占比。当取值为>=1的整数时,表示绝对像素。

Color

String

贴边颜色,格式为#后跟16进制值。例如:#000000。默认值为黑色。

Effect Type:Transition

转场效果出现在两个素材之间,只需要在对前一个素材设置转场过渡的时长,转场效果会作用于前一个素材的尾部与后一个素材的头部,在转场中,视频画面会进行叠加,因此其时长将比没有加转场效果少,减少的部分即为转场过渡的时长。

如:视频轨有2个素材,Clip1和Clip2,Clip1时长为10s,Clip2为8s,在Clip1与Clip2之间添加4s的转场效果,则视频轨的总时长由18s缩短到14s。

名称

类型

描述

SubType

String

转场子类型。转场效果示例

取值如下:directional displacement windowslice bowTieVertical bowTieHorizontal simplezoom linearblur waterdrop glitchmemories polka perlin directionalwarp bounce_up bounce_down wiperight wipeleft wipedown wipeup morph colordistance circlecrop swirl dreamy gridflip zoomincircles radial mosaic undulatingburnout crosshatch crazyparametricfun kaleidoscope windowblinds hexagonalize glitchdisplace dreamyzoom doomscreentransition_up doomscreentransition_down ripple pinwheel angular burn circle circleopen colorphase crosswarp cube directionalwipe doorway fade fadecolor fadegrayscale flyeye heart luma multiplyblend pixelize polarfunction randomsquares rotatescalefade squareswire squeeze swap wind

Duration

Float

转场效果的时长。单位:秒,精确到小数点后4位。

Effect Type:VFX

特效属性配置如下,具体特效效果参考文档:特效效果示例

名称

类型

描述

SubType

String

特效子类型,取值部分示例如下:

特效子类型,取值如下:

open(开幕)

close(闭幕)

h_blur(横向模糊)

v_blur(纵向模糊)

blur(模糊)

slightshake(轻微抖动)

zoominout(镜头变焦)

movie(电影感)

zoomslight(轻微放大)

zoom(逐渐放大)

withcircleopen(聚光灯打开)

withcircleclose(聚光灯关闭)

withcircleshake(聚光灯抖动)

withcircleflashlight(手电筒)

disappear(滑动消失)

shock(震惊)

bluropen(模糊开幕)

blurclose(模糊闭幕)

photograph(咔嚓)

black(曝光降低)

X

Float

该字段仅支持SubType为mosaic_rect/blur的情况。特效区域左上角距离输出视频左上角的横向距离。

注:支持百分比和像素两种形式。当取值为[0~0.9999]时,表示相对输出视频宽的占比。当取值为>=8的整数时,表示绝对像素。

Y

Float

该字段仅支持SubType为mosaic_rect/blur的情况。

特效区域距离输出视频左上角的纵向距离。注:支持百分比和像素两种形式。当取值为[0~0.9999]时,表示相对输出视频高的占比。当取值为>=8的整数时,表示绝对像素。

Width

Float

该字段仅支持SubType为mosaic_rect/blur的情况。特效区域在输出视频中的宽度。注:支持百分比和像素两种形式。当取值为[0~0.9999]时,表示相对输出视频宽的占比。当取值为>=8的整数时,表示绝对像素。

Height

Float

该字段仅支持SubType为mosaic_rect/blur的情况。特效区域在输出视频中的高度。注:支持百分比和像素两种形式。当取值为[0~0.9999]时,表示相对输出视频高的占比。当取值为>=8的整数时,表示绝对像素。

Effect Type:Volume

名称

类型

描述

Gain

Float

音量增益。取值范围:0-10。值越小音量越低,0表示静音;1表示原始音量;小于1表示低于原始音量;大于1表示高于原始音量。

TimelineIn

Float

调音区间出现在时间线的起始位置。单位:秒,精确到小数点后4位。如果TimelineIn不填,则会与对应Clip的TimelineIn保持一致

TimelineOut

Float

调音区间出现在时间线的结束位置。单位:秒,精确到小数点后4位。如果TimelineOut不填,则会与对应Clip的TimelineOut保持一致

Effect Type:AFade

名称

类型

描述

SubType

String

音频淡入淡出子类型。取值如下:In(淡入)Out(淡出)

Duration

Float

淡入或淡出的时长,淡入作用在素材片段的头部,淡出作用在素材片段的尾部

Transition 转场效果配置示例

以转场为例, 在输入的 Timeline 中配置需要的效果。 以下 Timeline 示例配置了在第1个视频和第2个视频中间增加对角切换的效果,时间是2s; 在第2个视频和第3个视频中间增加了水滴的转场效果,时长是1s。

MediaId1, MediaId2, MediaId3 需要替换成真实的媒资ID。 转场 Effect 中不需要配置 TimelineIn, TimelineOut.

{
  "VideoTracks": [
    {
      "VideoTrackClips": [
        {
          "MediaId": "MediaId1",
          "Effects": [
            {
              "Type": "Transition",
              "SubType": "directional",
              "Duration": 2
            }
          ]
        }, {
          "MediaId": "MediaId2",
          "Effects": [
            {
              "Type": "Transition",
              "SubType": "waterdrop",
              "Duration": 1
            }
          ]
        },{
          "MediaId": "MediaId3"
        }
      ]
    }
  ]
}

VFX 特效效果配置示例

以特效为例, 在输入的 Timeline 中配置需要的效果。MediaId1, MediaId2, MediaId3 需要替换成真实的媒资ID。

{
  "VideoTracks": [
    {
      "VideoTrackClips": [
        {
          "TimelineIn": 0,
          "Type": "Image",
          "TimelineOut": 3,
          "MediaId": "ImageId1",
          "Effects": [
            {
              "Type": "VFX",
              "TimelineIn": 0,
              "TimelineOut": 3,
              "SubType": "open"
            }
          ]
        },
        {
          "TimelineIn": 3,
          "Type": "Image",
          "TimelineOut": 6,
          "MediaId": "ImageId2",
          "Effects": [
            {
              "Type": "VFX",
              "TimelineIn": 3,
              "TimelineOut": 6,
              "SubType": "close"
            }
          ]
        },
        {
          "TimelineIn": 6,
          "Type": "Image",
          "TimelineOut": 9,
          "MediaId": "ImageId3",
          "Effects": [
            {
              "Type": "Filter",
              "SubType": "pl4",
              "TimelineIn": 6,
              "TimelineOut": 9
            }
          ]
        },
        {
          "TimelineIn": 9,
          "Type": "Image",
          "TimelineOut": 12,
          "MediaId": "ImageId2",
          "Effects": [
            {
              "SubType": "snow",
              "Type": "VFX",
              "TimelineIn": 9,
              "TimelineOut": 12
            }
          ]
        }
      ]
    }
  ],
  "AudioTracks": [
    {
      "AudioTrackClips": []
    }
  ],
  "Duration": 12
}