帮你快速理解、总结文档立即下载

Android

最近更新时间:2026-11-09 14:52:04
我的收藏

功能概览

通过动效相关接口,可以在短视频的指定时间段叠加一段 PAG 动画特效。本文介绍动效的添加、更新与删除,以及缩放模式和时间参数的设置。

相关接口类

接口类名
描述
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。
删除动效。

缩放模式常量

位于 TAVEditorConstants,用于 addMotionEffect(..., int scaleMode) 的 scaleMode 入参:
常量
值
对应 PAGScaleMode
说明
TAVEditorConstants.SCALE_MODE_NONE
0
None
不缩放,素材按原始尺寸渲染。
TAVEditorConstants.SCALE_MODE_STRETCH
1
Stretch
横纵分别拉伸铺满区域,可能变形。
TAVEditorConstants.SCALE_MODE_LETTER_BOX
2
LetterBox
等比缩放至完整可见,可能留黑边。
TAVEditorConstants.SCALE_MODE_ZOOM
3
Zoom
等比缩放至铺满区域,可能裁剪。

相关方法

添加动效

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

// 带缩放模式的添加方式(二选一,不要与上面同时声明同名变量)
int scaledMotionId = editor.addMotionEffect(path, startOffset, duration, scaleMode);

调整动效播放时间

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

删除动效

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