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

iOS

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

功能概览

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

相关接口类

接口类名
描述
TAVEditor
SDK 操作入口类。
TAVEffectInfo
动效信息模型(只读查询结果)。

接口方法汇总

方法
参数
返回值
说明
addMotionEffect:timeRange:
path:动效素材路径。
timeRange:动效展示区间。
int
添加动效并返回 ID。
updateMotionEffect:playRange:
effectId:动效 ID。
timeRange:动效展示区间。
void
更新动效播放时间。
setMotionEffect:trackIndex:
effectId:动效 ID。
trackIndex:轨道下标。
void
保存轨道下标(业务使用)。
removeMotionEffect:
effectId:动效 ID。
void
删除动效。
removeAllMotionEffect
-
void
删除所有动效。
getEffectInfos
-
NSArray<TAVEffectInfo *> *
获取当前所有已设置的动效。

动效相关方法

添加动效

/// 设置特效
/// - Parameters:
/// - path: 特效素材路径
/// - timeRange: 特效对应的时间区域
/// - return: 特效id
- (int)addMotionEffect:(NSString *)path timeRange:(CMTimeRange)timeRange;

调整动效播放时间

/// 更新特效播放时间
/// - Parameters:
/// - effectId: 创建特效时生成的id
/// - timeRange: 特效展示区间
- (void)updateMotionEffect:(int)effectId playRange:(CMTimeRange)timeRange;

删除动效

/// 删除特效
/// - Parameter effectId: 创建特效时生成的id
- (void)removeMotionEffect:(int)effectId;

/// 删除所有特效
- (void)removeAllMotionEffect;

TAVEffectInfo 字段

字段
类型
说明
effectId
int
动效 ID。
effectPath
NSString *
动效路径。
timeRange
CMTimeRange
动效在时间轴的播放区间。
extraInfo
NSDictionary *
扩展字段。
trackIndex
NSInteger
轨道下标(可用于业务)。

使用示例

// 添加动效(生效区间 0 ~ 2s)
CMTimeRange range = CMTimeRangeMake(kCMTimeZero, CMTimeMakeWithSeconds(2, 600));
int effectId = [editor addMotionEffect:@"/path/to/motion" timeRange:range];

// 调整动效播放时间(改为 3s ~ 5s)
[editor updateMotionEffect:effectId
playRange:CMTimeRangeMake(CMTimeMakeWithSeconds(3, 600), CMTimeMakeWithSeconds(2, 600))];

// 查询当前所有动效
NSArray<TAVEffectInfo *> *effects = [editor getEffectInfos];

// 删除动效
[editor removeMotionEffect:effectId];

// 删除所有动效
[editor removeAllMotionEffect];
说明:
添加/删除动效后需调用 flushImmediately 刷新预览才能看到效果。