功能概览
美颜、滤镜、特效(含动态贴纸类特效)统一由
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 *)effectNameeffectValue:(int)effectValueresourcePath:(NSString *)resourcePathextraInfo:(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:80resourcePath:lutPathextraInfo:@{@"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 | 冻结/恢复全局时间轴。 |