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

iOS

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

功能概览

美颜、滤镜、特效(含动态贴纸类特效)统一由 ITAVEffectManager 驱动,底层基于腾讯 XMagic SDK。业务方按效果名与资源路径下发参数,SDK 负责渲染。

相关接口类

接口类名
描述
ITAVEffectManager
设置美颜/滤镜/特效参数、合拍控制。
TAVRecorder
录制入口,通过 getEffectManager 获取特效管理器。
/// 获取美颜特效管理接口
- (id<ITAVEffectManager>)getEffectManager;

设置效果

接口

/// 设置特效参数
/// @param effectName 特效名称,对应 XMagic 的特效 key
/// @param effectValue 特效强度,具体含义因特效类型而异(如美白强度、滤镜程度等)
/// @param resourcePath 特效所需资源的本地路径,内置特效可传 nil
/// @param extraInfo 扩展参数字典,用于传递特效所需的额外配置,不需要时传 nil
- (void)setEffect:(NSString *)effectName
effectValue:(int)effectValue
resourcePath:(NSString *)resourcePath
extraInfo:(NSDictionary *)extraInfo;
参数
说明
effectName
效果名(美颜项 key、滤镜名、特效名等,由具体素材定义)。
effectValue
效果强度或取值。
resourcePath
素材路径;无需素材(如磨皮强度)时传 nil。
extraInfo
额外参数键值对,不需要时传 nil。

示例

id<ITAVEffectManager> effectManager = [recorder getEffectManager];

// 美颜:指定项与强度
[effectManager setEffect:@"beauty_smooth" effectValue:60 resourcePath:nil extraInfo:nil];

// 滤镜:指定 LUT 路径
[effectManager setEffect:@"filter_name"
effectValue:80
resourcePath:lutPath
extraInfo:@{@"intensity": @"0.8"}];

// 关闭某个效果(强度置 0)
[effectManager setEffect:@"beauty_smooth" effectValue:0 resourcePath:nil extraInfo:nil];

extraInfo 约定

extraInfo 的键由具体特效素材定义。SDK 内置的合拍相关 key 定义在 TAVDuetOperator.h 中:
Key 常量
字符串值
说明
kTAVDuetEntityComponent
entity.component
Entity 组件配置(ScreenTransform)。
kTAVDuetComponentJSON
entity.component.json
Entity 组件 JSON。
kTAVDuetComponentPause
entity.component.pause
Entity 组件暂停。
kTAVDuetComponentEnable
entity.component.enable
Entity 组件启用/禁用。
kTAVDuetAssetInput
asset.input
素材输入。
kTAVDuetAssetInputJSON
asset.input.json
素材输入 JSON。
kTAVDuetFlushTime
flush.time
刷新时间。
kTAVDuetTimelinePause
timeline.pause
冻结/恢复全局时间轴。