剪辑特效类

更新时间 : 2026-03-26 09:43:14

特效 SXEffect

特效包含转场、滤镜、视频动画等。由轨道或主轨道组添加时自动创建，不独立存在。

• 每种特效都有时间应用方式

//媒体素材路径,接受视频和图片素材
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);
//滤镜包素材路径
let filterPath: string = "";
//添加滤镜，时长为3秒，-1代表最末尾
let filterEffect: SXFilterEffect = track.addFilter(filterPath, 3, -1);
//效果时间跟随轨道开始显示时间（display time)
filterEffect.setEffectFollowType(SXEffectTimeFollowType.FOLLOW_START);
//效果时间反向跟随轨道out time(display + duration)
filterEffect.setEffectFollowType(SXEffectTimeFollowType.FOLLOW_END);
//效果时间以轨道时间保持一致
filterEffect.setEffectFollowType(SXEffectTimeFollowType.FOLLOW_WHOLE_PROCESS);

滤镜 SXFilterEffect

作用对象

• SXMediaTrack

//媒体素材路径,接受视频和图片素材
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);
//滤镜包素材路径
let filterPath: string = "";
//添加滤镜，时长为3秒，添加后的位置索引，0表示添加到首位，小于0或者大于总数均添加到末尾，此处-1代表最末尾
let filterEffect: SXFilterEffect = track.addFilter(filterPath, 3, -1);

设置选项

• 不透明度

//媒体素材路径,接受视频和图片素材
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);
//滤镜包素材路径
let filterPath: string = "";
//添加滤镜，时长为3秒，添加后的位置索引，0表示添加到首位，小于0或者大于总数均添加到末尾，此处-1代表最末尾
let filterEffect: SXFilterEffect = track.addFilter(filterPath, 3, -1);
//设置滤镜不透明度为0.5
filterEffect.setAlpha(0.5);

视频动画 SXAnimationEffect

作用对象

• SXMediaTrack

//媒体素材路径,接受视频和图片素材
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);

//动画特效资源路径
let animationPath: string = "";

//添加动画，时长为3秒，添加后的位置索引，0表示添加到首位，小于0或者大于总数均添加到末尾，此处-1代表最末尾
let animationEffect: SXAnimationEffect = track.addAnimation(animationPath, 3, -1);

视频特效 SXVideoEffect

作用对象

• SXMediaTrack

//媒体素材路径,接受视频和图片素材
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);
//视频特效资源路径
let videoEffectPath: string = "";
//添加视频特效，时长为3秒，添加后的位置索引，0表示添加到首位，小于0或者大于总数均添加到末尾，此处-1代表最末尾
let videoEffect:SXVideoEffect = track.addVideoEffect(videoEffectPath, 3, -1);

文字动画 SXTextAnimationEffect

作用对象

• SXTextTrack

//根据需求的宽、高、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!");
//文字动画资源路径
let textAnimationPath: string = "";
//添加文字动画，特效时长由素材包确定，添加后的位置索引，0表示添加到首位，小于0或者大于总数均添加到末尾，此处-1代表最末尾
let textAnimationEffect: SXTextAnimationEffect = textTrack.addTextAnimation(textAnimationPath, -1);

轨道动画 SXTrackAnimationEffect

作用对象

• SXStickerTrack

//贴纸包素材路径
let path: string = "";
//根据需求的宽、高、fps创建SXEditOptions
let options: SXEditOptions = new SXEditOptions(720, 1280, 25);
//使用SXEditOptions创建对应的SXEditManager
let manager: SXEditManager = SXEditManager.create(options);
//使用SXEditManager创建相应素材的贴纸轨道，可以指定轨道时长，单位为秒
let stickTrack: SXStickerTrack = manager.createStickerTrack(path， 10);
//轨道动画资源路径
let trackAnimationPath: string = "";
//添加轨道动画，时长为3秒，添加后的位置索引，0表示添加到首位，小于0或者大于总数均添加到末尾，此处-1代表最末尾
let trackAnimationEffect: SXTrackAnimationEffect = stickTrack.addTrackAnimation(trackAnimationPath, 3, -1);

颜色调节 SXColorAdjustEffect

作用对象

• SXMediaTrack

//媒体素材路径,接受视频和图片素材
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);
//添加颜色调节内置特效，时长为3秒，添加后的位置索引，0表示添加到首位，小于0或者大于总数均添加到末尾，此处-1代表最末尾
let genericEffect: SXGenericEffect = track.addGenericEffect(SXGenericEffectType.COLOR_ADJUSTMENT, 3, -1);
//色彩调节选项，均为float类型
//调节亮度，范围为[0..1]
genericEffect.setAttributeFloat(ColorAdjustmentAttrs.BRIGHTNESS, 1);
//调节对比度，范围为[-1..1]
genericEffect.setAttributeFloat(ColorAdjustmentAttrs.CONTRAST, 1);
//调节饱和度，范围为[-1..1]
genericEffect.setAttributeFloat(ColorAdjustmentAttrs.SATURATION, 1);
//调节锐化，范围为[-1..1]
genericEffect.setAttributeFloat(ColorAdjustmentAttrs.SHARPEN, 1);
//调节高光，范围为[0..1]
genericEffect.setAttributeFloat(ColorAdjustmentAttrs.HIGHLIGHT, 1);
//调节阴影，范围为[0..1]
genericEffect.setAttributeFloat(ColorAdjustmentAttrs.SHADOW, 1);
//调节曝光度，范围为[-1..1]
genericEffect.setAttributeFloat(ColorAdjustmentAttrs.EXPOSURE, 1);
//调节色相，范围为[0..1]
genericEffect.setAttributeFloat(ColorAdjustmentAttrs.HUE, 1);
//调节色温，范围为[-1..1]
genericEffect.setAttributeFloat(ColorAdjustmentAttrs.CCT, 1);