首页 > iOS SDK > 标准模板接入 > 预览

预览

更新时间 : 2023-07-18 09:32:59

预览模板流程

调用SXTemplate类的构造函数，并传入模板路径和SXTemplateUsagePreview作为参数构建一个SXTemplate实例对象
调用SXTemplatePlayer类的initWithTemplate构造函数，并传入SXTemplate对象和背景音乐路径来创建一个SXTemplatePlayer实例对象
调用SXTemplate的commit方法创建渲染对象
(可选) 利用UI Key等自定义逻辑对模板渲染对象进行精细修改调节
调用SXTemplatePlayer对象的getPlayerView方法来获取和播放器绑定的UIView对象，并将其加载到界面上用于显示预览画面
设置SXTemplatePlayer对象的 delegate 参数来设置播放状态监听委托对象
调用SXTemplatePlayer对象start，seek，pause，stop等方法对播放状态进行控制

代码示例

//创建模板
SXTemplate *sxtemplate = [[SXTemplate alloc] init:_templatePath type:SXTemplateUsagePreview];

//在传入播放器前可以先执行素材添加替换代码

//创建播放器
self.indexTemplatePlayer = [[SXTemplatePlayer alloc] initWithTemplate:sxtemplate audioPath:@"musicPath"];
self.indexTemplatePlayer.delegate = self;

UIView *playView = [self.indexTemplatePlayer getPlayerView];
/* 获取配置文件内记录的主视频合成宽高，可根据实际需求用来调整 playView 的 frame
int videoWidth = [sxtemplate mainCompWidth];
int videoHeight = [sxtemplate mainCompHeight];
*/

playView.frame = CGRectMake(0, 0, self.view.frame.size.width, self.view.frame.size.height);

[sxtemplate commit];

播放控制

//暂停播放
[self.indexTemplatePlayer pause];
//播放跳转   second 表示新的时间进度，秒为单位
[self.indexTemplatePlayer seek:second];
//开始播放
[self.indexTemplatePlayer start];

预览进度，通过SXTemplatePlayerDelegate的playFrameIndex获取

/**
 * 播放进度更新  
 * @param frameIndex 当前播放的帧序列号  
 */
- (void)playFrameIndex:(NSInteger)frameIndex {

}

注意事项

SXTemplate初始化时type类型为预览 SXTemplateUsagePreview
注意方法调用的顺序，顺序不对可能会导致异常
如果从相册里选择的素材需要进行裁剪，可以参考demo，SDK不提供素材预处理操作
对于预览方法来说，普通模板和动态模板调用方法一致
在 SXTemplatePlayer 释放前调用 stop 方法释放资源，stop 后需要重新调用 commit 方法，如果不是释放 player 暂停建议使用 pause 方法。