Android

最近更新时间:2025-12-23 16:43:42

我的收藏

功能概览

剪同款能够实现一键成片,通过剪同款功能接口能加载制作好的模板,用户添加视频或图片能实现音乐卡点及炫酷转场视频。

相关接口类

接口类名
描述
TAVEditor
SDK 操作入口类。
TAVTemplateConfig
模板配置信息类。

接口方法汇总

方法
参数
返回值
说明
setTemplateDir(String path)
path:模板目录绝对路径。
int
0:成功
-1:路径无效
-2:授权无效
设置模板工作目录。
getTemplateDir()
-
String
获取当前模板目录。
getTemplateConfig(String templatePath)
templatePath:模板路径。
TAVTemplateConfig
获取模板配置信息。

剪同款相关方法

设置模板路径

/**
* 设置模板路径
*
* @param path 模板目录绝对路径
* @return 操作结果代码:
* 0: 成功
* -1: 路径无效
* -2: 授权无效
*/
int setTemplateDir(String path);

获取模板路径

/**
* 获取当前设置的模板路径
*
* @return 模板目录的绝对路径
*/
String getTemplateDir();

获取模板配置

/**
* 获取模板坑位信息
*
* @param templatePath 模板路径
* @return 模板配置对象,包含坑位信息
*/
TAVTemplateConfig getTemplateConfig(String templatePath);

TAVTemplateConfig 结构说明

TAVTemplateConfig 类包含以下关键信息:
坑位列表:模板中的可替换元素位置。
视频轨道配置:主视频轨道的参数。
音频轨道配置:背景音轨的参数。
特效配置:内置特效参数。

使用示例

// 设置模板路径
int result = editor.setTemplateDir("/sdcard/templates/project1");
if (result == 0) {
// 获取模板路径
String templateDir = editor.getTemplateDir();
// 获取模板配置
TAVTemplateConfig config = editor.getTemplateConfig(templateDir);
// 使用配置信息
List<TAVTemplateSlot> slots = config.getSlots();
for (TAVTemplateSlot slot : slots) {
// 处理每个坑位
}
} else {
// 处理错误
switch (result) {
case -1:
Log.e("Template", "无效的模板路径");
break;
case -2:
Log.e("Template", "模板授权无效");
break;
}
}

错误处理指南

错误代码
含义
解决方案
-1
路径无效
检查路径是否存在且有读取权限。
-2
授权无效
检查模板授权文件是否有效。