剪辑轨道类

更新时间 : 2026-03-26 09:36:09

剪辑轨道类

轨道，分为多媒体轨道，贴纸轨道，文字轨道和音频轨道。 需要通过SXEditManager 或 SXComposite 来初始化。

1.SXTrack

轨道基类，包含所有轨道共有的属性。

其中轨道在 SXEditManager 的展示时间主要由三个属性决定，startTime，offsetTime和duration。

displayTime = startTime + offsetTime。

可以参考文档Start Time, In Point, Out Point讲解，其中inPoint对应displayTime。

2.SXAudioTrack

音频轨道，可以修改音量，音调，淡入淡出，速度等属性。

3.SXRenderTrack

渲染轨道，是可视化轨道类的基类，主要包含一些视觉信息，如位置类的信息，透明度等。

媒体轨道

创建媒体轨道

//媒体素材路径,接受视频和图片素材
let path: string = "";
//根据需求的宽、高、fps创建SXEditOptions
let options: SXEditOptions = new SXEditOptions(720, 1280, 25);
//使用SXEditOptions创建对应的SXEditManager
let manager: SXEditManager = SXEditManager.create(options);
//使用SXEditManager创建相应素材的媒体轨道，图片轨道时长默认时长为3秒，其他素材使用素材自身时长
let track: SXMediaTrack = manager.createMediaTrack(path);

媒体轨道设置变速

//设置媒体轨道两倍速
track.setSpeed(2);

媒体轨道设置蒙版

//创建SXShape对象
let shape: SXShape = SXShape.create();
//给SXShape添加一个圆心为(0,0)，半径为radius的圆
shape.circle(0, 0, radius);
//设置蒙版形状
track.setMaskShape(shape);

媒体轨道设置转场

//转场包素材路径
let path: string = "";
//设置转场，可以自定义转场的时长
track.setTransition(path, 3);
//移除转场
track.removeTransition();

裁剪媒体轨道

//指定裁剪的大小和矩阵，示例为原始矩阵
track.setCropData(width, height, [1, 0, 0, 0, 1, 0]);

贴纸轨道

创建贴纸轨道

//贴纸包素材路径
let path: string = "";
//根据需求的宽、高、fps创建SXEditOptions
let options: SXEditOptions = new SXEditOptions(720, 1280, 25);
//使用SXEditOptions创建对应的SXEditManager
let manager: SXEditManager = SXEditManager.create(options);
//使用SXEditManager创建相应素材的贴纸轨道，可以指定轨道时长，单位为秒
let track: SXStickerTrack = manager.createStickerTrack(path， 10);

贴纸轨道增加动画

//轨道动画素材路径
let path: string = "";
//添加轨道动画，动画时间线不能重叠，入场/出场动画不能与循环动画共存，否则添加失败
SXTrackAnimationEffect effect = track.addTrackAnimation(path, 10, 0);

文字轨道

创建文字轨道

//根据需求的宽、高、fps创建SXEditOptions
let options: SXEditOptions = new SXEditOptions(720, 1280, 25);
//使用SXEditOptions创建对应的SXEditManager
let manager: SXEditManager = SXEditManager.create(options);
//使用SXEditManager创建文字轨道，可以指定轨道时长，单位为秒
let textTrack: SXTextTrack = manager.createTextTrack(10);
//设置文字内容
textTrack.setContent("Hello World!");

文字轨道设置字体，颜色，大小等

//设置描边宽度
textTrack.setStrokeWidth(20);
//设置描边颜色
textTrack.setStrokeColorString("#0000FF");
//设置填充颜色
textTrack.setFillColorString("#FF0000");
//设置字体大小
textTrack.setFontSize(15);
//字体文件路径
let fontFile: string = "";
//设置字体文件
textTrack.setFontFile(fontFile);
//设置文字方向为纵向
textTrack.setDirection(SXTextDirectionType.VERTICAL);
//设置文字对齐方式为居中对齐
textTrack.setAlignment(SXTextAlignmentType.CENTER);

文字轨道设置文字样式

//文字样式素材路径
let path: string = "";
//设置指定的文字样式
textTrack.setTextStyle(path);
//去除已设置的文字样式
textTrack.resetTextStyle();

音频轨道

创建音频轨道

//音频素材路径,接受视频和音频文件
let path: string = "";
//根据需求的宽、高、fps创建SXEditOptions
let options: SXEditOptions = new SXEditOptions(720, 1280, 25);
//使用SXEditOptions创建对应的SXEditManager
let manager: SXEditManager = SXEditManager.create(options);
//使用SXEditManager创建相应素材的音频轨道，可以指定轨道时长，单位为秒
let audioTrack: SXAudioTrack = manager.createAudioTrack(path, 10);

音频轨道设置

//设置淡入时长，单位为s
audioTrack.setFadeInDuration(5);
//设置淡出时长，单位为s
audioTrack.setFadeOutDuration(5);
//设置变速，默认为1
audioTrack.setSpeed(0.5);
//设置音量，默认为1
audioTrack.setVolume(1.5);
//设置音调，默认为1
audioTrack.setPitch(2);

模板轨道

创建模板轨道

//模板包素材路径
let path: string = "";
//使用模板素材包路径创建SXResource
let resource: SXResource = SXResource.createResourceWithFilePath(SXResourceType.Template, path);
//根据需求的宽、高、fps创建SXEditOptions
let options: SXEditOptions = new SXEditOptions(720, 1280, 25);
//使用SXEditOptions创建对应的SXEditManager
let manager: SXEditManager = SXEditManager.create(options);
//使用SXEditManager创建相应素材的模板轨道，模板轨道素材包决定轨道时长
let templateTrack: SXTemplateTrack = manager.createTemplateTrack(resource);

模板轨道设置可替换素材

//详细的json格式可参见https://www.vesdk.com/docs/template/page_103.html
templateTrack.setReplaceJson("");

调整轨道

创建调整轨道

//根据需求的宽、高、fps创建SXEditOptions
let options: SXEditOptions = new SXEditOptions(720, 1280, 25);
//使用SXEditOptions创建对应的SXEditManager
let manager: SXEditManager = SXEditManager.create(options);
//使用SXEditManager创建相调整轨道，可以指定轨道时长，单位为秒
let track: SXAdjustmentTrack = manager.createAdjustmentTrack(10);