首页 > 剪辑管理类

剪辑管理类

更新时间 : 2026-03-23 16:10:11

SXEditManager

SXEditManager管理剪辑上下文中的所有资源:创建和删除轨道、创建和删除轨道组，管理预览和渲染。占用内存较多，建议同一时间只存在一个实例。

初始化时需要SXEditOptions对象来定义初始化参数

//创建一个宽为720、高为1280、fps为25的SXEditOptions，和需要导出的视频一致即可
let options: SXEditOptions = new SXEditOptions(720, 1280, 25);

修改相关设置

//修改宽度
options.setWidth(1080);
//修改高度
options.setHeight(1920);
//修改帧率
options.setFps(30);
//设置缩放比例为50%
options.setScale(50);
//设置sdk默认字体
options.setFontFile("<字体路径>");
//设置是否开启预加载，若开启会花费更多内存，但会增加渲染速度
options.setEnableSourceManager(true);

轨道组和轨道组的操作见轨道组
轨道类见轨道类
设置背景

let options: SXEditOptions = new SXEditOptions(720, 1280, 25); 
let manager: SXEditManager = SXEditManager.create(options);
//把背景设置为红色 十六进制颜色字符串, 比如 #00FF00, #00FF00FF
manager.setBackgroundColorByHexString("#FF0000");
//把背景设置为红色 分别为RGB值，范围为0-1
manager.setBackgroundColor(1, 0, 0);

查找某个坐标处的轨道

let options: SXEditOptions = new SXEditOptions(720, 1280, 25); 
let manager: SXEditManager = SXEditManager.create(options);
//查找(x, y)点最上层的轨道，找到返回轨道对象，否则返回NULL
let track: SXTrack = manager.hitTest(x, y);
//查找点(x, y)处最上层对应类型的轨道，示例为查找媒体轨道，可以同时查找多个类型，使用符号 “|” 链接
let track: SXTrack = manager.hitTestInType(x, y, SXTrackType.SX_TRACK_TYPE_MEDIA);
//查找(x, y)点所有的轨道，找到返回轨道对象，否则返回NULL
let tracks: List<SXTrack> = manager.hitTestEx(x, y);
//查找点(x, y)处所有对应类型的轨道，示例为查找媒体轨道，可以同时查找多个类型，使用符号 “|” 链接
let tracks: List<SXTrack> = manager.hitTestExInType(x, y, SXTrackType.SX_TRACK_TYPE_MEDIA);

预览

let options: SXEditOptions = new SXEditOptions(720, 1280, 25); 
let manager: SXEditManager = SXEditManager.create(options);
//开始预览播放
manager.start();
//暂停预览
manager.pause();
//当前是否正在播放
let isPlaying: boolean = manager.isPlaying();
//设置播放进度 单位为s
manager.seek(2);

渲染

//开始渲染，需要传入app有权限能访问到的路径
manager.export("<文件保存路径>")

//修改宽度 options.setWidth(1080); //修改高度 options.setHeight(1920); //修改帧率 options.setFps(30); //设置缩放比例为50% options.setScale(50); //设置sdk默认字体 options.setFontFile("<字体路径>"); //设置是否开启预加载，若开启会花费更多内存，但会增加渲染速度 options.setEnableSourceManager(true);

let options: SXEditOptions = new SXEditOptions(720, 1280, 25); let manager: SXEditManager = SXEditManager.create(options); //把背景设置为红色十六进制颜色字符串, 比如 #00FF00, #00FF00FF manager.setBackgroundColorByHexString("#FF0000"); //把背景设置为红色分别为RGB值，范围为0-1 manager.setBackgroundColor(1, 0, 0);

let options: SXEditOptions = new SXEditOptions(720, 1280, 25); let manager: SXEditManager = SXEditManager.create(options); //查找(x, y)点最上层的轨道，找到返回轨道对象，否则返回NULL let track: SXTrack = manager.hitTest(x, y); //查找点(x, y)处最上层对应类型的轨道，示例为查找媒体轨道，可以同时查找多个类型，使用符号 “|” 链接 let track: SXTrack = manager.hitTestInType(x, y, SXTrackType.SX_TRACK_TYPE_MEDIA); //查找(x, y)点所有的轨道，找到返回轨道对象，否则返回NULL let tracks: List<SXTrack> = manager.hitTestEx(x, y); //查找点(x, y)处所有对应类型的轨道，示例为查找媒体轨道，可以同时查找多个类型，使用符号 “|” 链接 let tracks: List<SXTrack> = manager.hitTestExInType(x, y, SXTrackType.SX_TRACK_TYPE_MEDIA);

let options: SXEditOptions = new SXEditOptions(720, 1280, 25); let manager: SXEditManager = SXEditManager.create(options); //开始预览播放 manager.start(); //暂停预览 manager.pause(); //当前是否正在播放 let isPlaying: boolean = manager.isPlaying(); //设置播放进度单位为s manager.seek(2);