Home.md

-日期：2019-11-14
-
 # 1.概述
 iOS短视频SDK是适用于iOS平台的短视频SDK。使用此SDK可以实现短视频相关功能。
 ## 1.1 功能特性
@@ -17,6 +15,7 @@ iOS短视频SDK是适用于iOS平台的短视频SDK。使用此SDK可以实现
 | 气泡文字 | 支持根据时段，位置添加气泡文字 |
 | 音频插入 | 支持对视频插入背景音乐 |
 |  视频大小修改 | 支持修改视频分辨率 |
+| 图片合成视频 | 支持多图片合成视频，添加动效 |
 
 ##  1.2 阅读对象
 本文档为技术文档，需要阅读者：
@@ -904,7 +903,85 @@ if (!self.canEdit) {
 +(CGFloat)dw_fileSizeAtPath:(NSString*)filePath;
 ```
 
-## 4.11 Demo具体使用
+## 4.11 图片合成视频功能的使用
+通过多张图片及图片特效，转场特效生成一段视频。使用步骤如下：
+
+### 4.11.1 通过选取的图片，图片特效，转场特效等参数，生成DWPictureNodeModel对象
+```
+//图片特效通过DWPictureAnimation类生成
+/// 返回图片特效动画数据
+/// @param style 特效样式
+/// @param pictureDuration 图片特效持续时间
+/// @param frontTransitionDuration 转场动画持续时间
+/// @param videoSize 合成视频的大小，左滑，右滑特效需要。
+/// @param isLast 是否是最后一张图片
++(NSArray *)pictureAnimationCreateWithStyle:(DWPictureAnimationStyle)style
+                            PictureDuration:(CGFloat)pictureDuration
+                    FrontTransitionDuration:(CGFloat)frontTransitionDuration
+                                  VideoSize:(CGSize)videoSize
+                                     isLast:(BOOL)isLast;
+                                     
+//转场特效通过DWTransitionAnimation类生成
+/// 返回转场动画特效
+/// @param style 转场动画样式
+/// @param beginTime 特效持续时间
+/// @param duration 转场动画持续时间
+/// @param videoSize 合成视频的大小
+/// @param isFront 转场特效是否在图片之前
++(NSArray *)transitionAnimationCreateWithStyle:(DWTransitionAnimationStyle)style
+                                     BeginTime:(CGFloat)beginTime
+                                      Duration:(CGFloat)duration
+                                     VideoSize:(CGSize)videoSize
+                                       isFront:(BOOL)isFront;
+
+//生成圆形动画
++(NSArray *)circleMaskAnimationCreateWithDuration:(CGFloat)duration
+                                        VideoSize:(CGSize)videoSize;
+
+
+//DWPictureNodeModel节点对象的创建
+DWPictureNodeModel * pictureNodeModel = [[DWPictureNodeModel alloc]init];
+pictureNodeModel.image = ...; //图片，非空
+pictureNodeModel.beginTime = ...; //图片特效起始时间
+pictureNodeModel.duration = ...; //图片特效持续时间
+pictureNodeModel.animations = ...; //图片特效及转场特效，DWPictureAnimation，DWTransitionAnimation 生成的特效数组集合。
+pictureNodeModel.maskLayer = ...; //图层layer的mask图层，用于辅助完成动画效果
+pictureNodeModel.maskAnimationBeginTime = ...; //mask图层特效开始时间
+pictureNodeModel.maskAnimationDuration = ...; //mask图层特效持续时间
+pictureNodeModel.maskAnimations = ...; //mask图层的特效
+pictureNodeModel.isCover = ...; //图层layer的添加顺序
+
+详细实现逻辑，可参考DWShortPictureCompositeViewController中-(NSArray *)resetPictureNodeAniationsWithSize:(CGSize)aniationsSize AndCreateVideo:(BOOL)isCreateVideo;方法的实现逻辑。
+
+```
+
+###4.11.2 创建DWPictureCompositeInstrument对象，设置适当的参数，生成视频
+```
+//根据DWPictureNodeModel节点对象，初始化视频生成器
+DWPictureCompositeInstrument * instrument = [[DWPictureCompositeInstrument alloc]init];
+instrument.videoSize = ...; //视频分辨率，非空
+instrument.videoBackgroundColor = ...; //合成视频底色，默认纯黑
+instrument.outPath = ...; 视频导出路径，非空
+instrument.pictureNodeModels = ...; //步骤1所生成的节点对象数组
+instrument.videoDuration = ...;//视频总时间    
+//开始生成视频
+[instrument startComposite];
+//成功or失败回调
+instrument.complete = ^(NSError *error, NSURL *completeFileURL) {
+        if (error) {
+           //视频生成失败处理及原因
+           return;
+        }
+        //视频生成成功
+        ...
+    };
+    
+详细实现逻辑，可参考DWShortPictureCompositeViewController中-(void)nextButtonAction方法。
+    
+```
+
+
+## 4.12 Demo具体使用
 Demo是示例源码，可直接用Xcode运行。Demo的设计旨在展示SDK各项功能的使用方法，如果希望应用获得更好的使用体验，要根据需求自行更改。
 如果在使用SDK过程中遇到其他问题请联系CC客服进行反馈。
 
@@ -914,4 +991,3 @@ Demo是示例源码，可直接用Xcode运行。Demo的设计旨在展示SDK各
 [https://github.com/CCVideo/VOD_iOS_ShortVideo_SDK/tree/master/doc/api](https://github.com/CCVideo/VOD_iOS_ShortVideo_SDK/blob/master/doc/api)
 
 # 6.Q&A
-