Android

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

我的收藏

功能概览

通过动效相关接口,可以对短视频添加一段动态转场效果,本文提供动效管理功能,包括添加、更新和删除动效,支持设置缩放模式和时间参数等。

相关接口类

接口类名
描述
TAVEditor
SDK 操作入口类。

接口方法汇总

方法
参数
说明
addMotionEffect(String path, long startOffset, long duration)
path:动效路径。
startOffset:开始时间(微秒)。
duration:持续时间(微秒)。
添加动效并返回 ID。
addMotionEffect(String path, long startOffset, long duration, int scaleMode)
path:动效路径。
startOffset:开始时间(微秒)。
duration:持续时间(微秒)。
scaleMode:缩放模式。
添加带缩放模式的动效。
updateMotionEffectPlayRange(int motionId, long startOffset, long duration)
motionId:动效 ID。
startOffset:新开始时间(微秒)。
duration:新持续时间(微秒)。
更新动效播放时间。
removeMotionEffect(int motionId)
motionId:动效 ID。
删除动效。

缩放模式常量

常量
说明
SCALE_MODE_FIT
0
适应模式。
SCALE_MODE_FILL
1
填充模式。

相关方法

添加动效

// 基本添加方式
int motionId = editor.addMotionEffect(path, startOffset, duration);

// 带缩放模式的添加方式
int motionId = editor.addMotionEffect(path, startOffset, duration, scaleMode);

调整动效播放时间

/**
* 调整动效播放时间
*
* @param motionId 动效ID
* @param startOffset 开始时间(微秒)
* @param duration 持续时间(微秒)
*/
editor.updateMotionEffectPlayRange(motionId, startOffset, duration);

删除动效

/**
* 删除动效
*
* @param motionId 动效ID
*/
editor.removeMotionEffect(motionId);