短视频 SDK iOS（剪同款）

一、相关接口类

注意：说明：

注意：剪同款场景统一使用 TAVTemplateEditor：通过 [TAVMagicBase createTemplateEditorWithRenderSize:] 创建。TAVEditor 用于普通短视频编辑，其中保留了 setTemplate: / getTemplateConfig: 等模板接口，也可完成剪同款，但能力边界与 TAVTemplateEditor 不同。

二、创建剪同款编辑器

#import <TAVMagic/TAVMagicBase.h>#import <TAVMagic/TAVTemplateEditor.h>// 剪同款入口（需先调用 [TAVMagicBase initSDK:]）TAVTemplateEditor *editor = [TAVMagicBase createTemplateEditorWithRenderSize:CGSizeZero];// 等价写法TAVTemplateEditor *editor = [TAVTemplateEditor templateEditorWithRenderSize:CGSizeZero];// 初始化预览（必须在其它接口之前调用）TAVPreviewParam *param = [[TAVPreviewParam alloc] init];param.videoView = self.previewContainerView; // 预览容器param.loop = YES;param.observer = self;[editor setPreview:param];

三、剪同款主链路

四、获取模板配置

/// 获取视频模版坑位信息/// – Parameter templatePath: 视频模版素材路径- (TAVTemplateConfig *)getTemplateConfig:(NSString *)templatePath;

通常在填充素材前调用，用于读取模板的坑位数量、媒体类型限制（视频/图片/混合）、每个坑位的时长要求，以便在添加媒体资源前做合法性校验。路径无效时返回 nil。

五、应用模板

/// 应用模板/// – Parameter templatePath: 视频模版素材路径/// – return: 0 成功，1 路径无效，2 无权限- (TAVTemplateCode)setTemplate:(NSString *)templatePath;

TAVTemplateCode：

六、获取可替换素材列表

/// 获取模板中所有可替换项，需在 setTemplate: 成功后调用/// – Returns: TAVReplaceItem 数组，按出现时间升序排列- (NSArray<TAVReplaceItem *> *)getReplaceItems;

TAVReplaceItem 字段：

TAVTextReplaceItem（TAVReplaceItem 子类）字段：

七、替换模板素材

/// 将替换项的修改内容同步到模板，修改立即生效/// – Parameter item: 经 getReplaceItems 获取并修改内容后的替换项- (void)replaceItem:(TAVReplaceItem *)item;

文字替换示例：

for (TAVReplaceItem *item in [editor getReplaceItems]) { if (item.type == TAVTemplateReplaceTypeText) { TAVTextReplaceItem *textItem = (TAVTextReplaceItem *)item; textItem.src = @"新的文案"; [editor replaceItem:textItem]; }}

八、设置渲染尺寸

/// 设置当前渲染大小- (void)setRenderSize:(CGSize)renderSize;/// 获取当前渲染大小- (CGSize)getRenderSize;

注意：说明：

注意：剪同款模板通常固定为 9:16 竖屏，建议在添加资源前调用，避免渲染链重建。

九、派生独立编辑器

/// 从当前编辑对象派生一个实例，返回实例保留当前的素材、裁剪、音量、滤镜等编辑状态/// 返回实例由调用方负责 deinit- (instancetype)fork;

注意：说明：

注意：fork 不接受预览参数，派生出的实例不绑定预览容器，可直接用于导出。

十、TAVTemplateEditor 其余能力

注意：TAVTemplateEditor 未提供滤镜、动效、贴纸、画中画、草稿等接口，这些能力由 TAVEditor 提供；剪同款模板内的音视频、转场等由模板 JSON 驱动。模板自带音乐的 bgmId 固定为 TEMPLATE_DEFAULT_BGM_ID（-10001）。

十一、TAVTemplateConfig 结构说明

TAVAudioPlaceHolder 字段：

十二、使用示例

// 1. 创建剪同款编辑器并初始化预览TAVTemplateEditor *editor = [TAVMagicBase createTemplateEditorWithRenderSize:CGSizeZero];TAVPreviewParam *param = [[TAVPreviewParam alloc] init];param.videoView = self.previewContainerView;param.loop = YES;[editor setPreview:param];// 2. 读取模板配置TAVTemplateConfig *config = [editor getTemplateConfig:@"/path/to/template"];if (config == nil) { // 模板路径无效 return;}// 3. 按坑位填充素材NSArray<TAVClipPlaceHolder *> *clipHolders = config.clipPlaceHolders;[editor addVideoClip:@"/path/to/a.mp4"];[editor addImageClip:@"/path/to/b.jpg" duration:clipHolders[1].contentDuration];// 4. 应用模板TAVTemplateCode ret = [editor setTemplate:@"/path/to/template"];if (ret != TAVTemplateCodeSuccess) { // ret == TAVTemplateCodePathInvalid：路径无效 // ret == TAVTemplateCodeAuthInvalid：模板授权无效 return;}// 5. 刷新[editor flushImmediately];// 6. 替换模板中的文字for (TAVReplaceItem *item in [editor getReplaceItems]) { if (item.type == TAVTemplateReplaceTypeText) { TAVTextReplaceItem *textItem = (TAVTextReplaceItem *)item; textItem.src = @"新的文案"; [editor replaceItem:textItem]; }}// 7. 启动播放[editor play];// 8. 导出成片[editor generateVideoWithCompressed:TAVVideoCompressed720P outputPath:@"/path/to/output.mp4" progress:^(CGFloat progress) {} completion:^(NSError *error, NSString *outputPath) { // error 为 nil 表示导出成功}];// 9. 离开编辑页时释放[editor deinit];

十三、错误处理指南