全部产品

Timeline配置说明

时间线是将素材按照视频创意进行编排和特效设计的产物。时间线主要包含轨道、素材、效果3种对象,下面介绍

名称

类型

描述

VideoTracks

VideoTrack[]

视频轨列表。多个轨道的层叠顺序与数组元素顺序一致,如:数组的第一个元素图层的t在最底层,第二个元素的图层在其之上,以此类推。

AudioTracks

AudioTrack[]

音频轨列表。

ImageTracks

ImageTrack[]

图片轨列表。注:

1)图片轨需叠加在视频轨之上,图片本身作为素材与视频混编时(如图片合成视频场景),请使用视频轨VideoTracks

2)多个轨道的层叠顺序与数组元素顺序一致,如:数组的第一个元素图层的t在最底层,第二个元素的图层在其之上,以此类推

SubtitleTracks

SubtitleTrack[]

字幕轨列表。

VideoTrack

视频轨VideoTrack用于编排图像素材,包括视频素材和图片素材。

名称

类型

描述

Count

Int

视频轨素材片段总数

Duration

Float

视频轨时长。单位:秒,精确到小数点后4位。

VideoTrackClips

VideoTrackClip[]

视频轨素材片段列表

AudioTrack

音频轨AudioTrack用于编排音频素材,包括纯音频素材和带音频的视频素材。

名称

类型

描述

Count

Int

音频轨素材片段总数

Duration

Float

音频轨时长。单位:秒,精确到小数点后4位。

AudioTrackClips

AudioTrackClip[]

音频轨素材片段列表

ImageTrack

图片轨ImageTrack用于编排图片素材。

名称

类型

描述

Count

Int

图片轨素材片段总数

Duration

Float

图片轨时长。单位:秒,精确到小数点后4位。

ImageTrackClips

ImageTrackClip[]

图片轨素材片段列表

SubtitleTrack

字幕轨SubtitleTrack用于编排字幕,包括横幅文字和外挂字幕。

名称

类型

描述

Count

Int

字幕轨素材片段总数

Duration

Float

字幕轨时长。单位:秒,精确到小数点后4位。

SubtitleTrackClips

SubtitleTrackClip[]

字幕轨素材片段列表

VideoTrackClip

视频轨素材VideoTrackClip的范围包括视频素材和图片素材。

名称

类型

描述

MediaId

String

视频轨素材片段对应的媒资库资源Id注:视频对应媒资库资源的VideoId,图片对应媒资库资源的ImageId

Type

String

素材片段类型。取值:Video(视频); Image(图片) 默认Video

In

Float

素材片段相对于素材的入点,在素材类型是音视频时使用。单位:秒,精确到小数点后4位。如果In不填,默认为0

Out

Float

素材片段相对于素材的出点,在素材类型是音视频时使用。单位:秒,精确到小数点后4位。如果Out不填,默认为0

Duration

Float

素材片段的时长,一般在素材类型是图片时使用。单位:秒,精确到小数点后4位

DyncFrames

Int

动图的帧率,在素材类型是图片且为动图时使用。

TimelineIn

Float

素材片段相对于时间线的入点。单位:秒,精确到小数点后4位。如果TimelineIn不填,则会按照素材片段顺序相接的方式自动计算TimelineIn

TimelineOut

Float

素材片段相对于时间线的出点。单位:秒,精确到小数点后4位。如果TimelineOut不填,则会按照素材片段顺序相接的方式自动计算TimelineOut

Effects

Effect[]

素材片段的效果列表

AudioTrackClip

音频轨素材AudioTrackClip的范围包括纯音频素材和有音频流的视频素材。

名称

类型

描述

MediaId

String

音频轨素材片段对应的媒资库资源Id注:视频对应媒资库资源的VideoId

In

Float

素材片段相对于素材的入点。单位:秒,精确到小数点后4位。如果In不填,默认为0

Out

Float

素材片段相对于素材的出点。单位:秒,精确到小数点后4位。如果Out不填,默认为0

TimelineIn

Float

素材片段相对于时间线的入点。单位:秒,精确到小数点后4位。如果TimelineIn不填,则会按照素材片段顺序相接的方式自动计算TimelineIn

TimelineOut

Float

素材片段相对于时间线的出点。单位:秒,精确到小数点后4位。如果TimelineOut不填,则会按照素材片段顺序相接的方式自动计算TimelineOut

Effects

Effect[]

素材片段的效果列表

ImageTrackClip

图像轨素材ImageTrackClip的范围包括图片素材。

名称

类型

描述

MediaId

String

素材对应的媒资库图片资源MediaId

MediaURL

String

素材对应的媒资库图片资源地址,必须为oss格式的。MediaId与MediaURL均不为空时,优先使用MediaId

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不填,默认值为0

TimelineOut

Float

图片出现在时间线的结束位置。单位:秒,精确到小数点后4位。如果TimelineOut不填,默认值为视频轨的最大时长

DyncFrames

Int

动图的帧率,在素材为动图时使用。

Effects

Effect[]

素材的效果列表

SubtitleTrackClip

字幕轨素材SubtitleTrackClip的范围包括字幕素材。

名称

类型

描述

Type

String

字幕素材类型。取值:Subtitle(外挂字幕文件);Text(横幅文字)

SubType

String

字幕素材子类型。取值:srt(外挂srt字幕);ass(外挂ass字幕)字幕素材类型为横幅文字时,可忽略该字段。

FileURL

String

当字幕类型为外挂字幕时,字幕文件对应的oss地址

X

Float

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

Y

Float

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

TimelineIn

Float

当字幕类型为横幅文字时,表示文字出现在时间线的起始位置。单位:秒,精确到小数点后4位。如果TimelineIn不填,则会按照素材顺序相接的方式自动计算TimelineIn

TimelineOut

Float

当字幕类型为横幅文字时,表示文字出现在时间线的结束位置。单位:秒,精确到小数点后4位。如果TimelineOut不填,则会按照素材顺序相接的方式自动计算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

当字幕类型为横幅文字时,表示文字的字体外观。

FontFace

字体样式FontFace

名称

类型

描述

Bold

Boolean

加粗

Italic

Boolean

斜体

Underline

Boolean

下划线

Effect

素材效果Effect

不同的效果类型,有不同的属性可以设置,同时有一些共通的属性,比如 Type, SubType。

Effect 通用属性如下

名称

类型

描述

Type

String

效果类型。取值如下:

  • Text(横幅文字:视频轨素材)

  • DeWatermark(模糊:视频轨素材)

  • Crop(裁剪:视频轨素材)

  • Pad(贴边:视频轨素材)

  • Scale(缩放:视频轨素材)

  • Transition(转场:视频轨素材)

  • VFX(特效:视频规素材)

  • Volume(音量调整:音频轨素材)

  • AFade(音频淡入淡出:音频轨素材)

SubType

String

效果子类型

  • 当Type为Transition时,会进一步描述转场子类型。取值见:转场效果示例

TimelineIn

Float

效果相对于时间线的入点。单位:秒,精确到小数点后4位

TimelineOut

Float

效果相对于时间线的出点。单位:秒,精确到小数点后4位

各类 Effect 的独立属性描述,详见 Effect配置说明