锐动IOS带UI视频编辑SDK

Posted 2020-12-01

1 编写目的

预期读者：

有视频编辑开发经验或者无经验的，打算或者正在使用“锐动ios带UI视频编辑SDK”的相关工程师。

 iOS软件工程师。

 产品经理。

 QA

 

2 名词解释

       分辨率：用于计算机视频处理的图像，以水平和垂直方向上所能显示的像素数来表示分辨率。常见视频分辨率的有1080P即1920x1080，720P即1080x720，640x480等。

       宽高比：视频分辨率的宽高比，常见的有16:9，4:3，1:1。锐动视频编辑SDK对各宽高比的视频都支持编辑，导出的默认分辨率是1280x720，宽高比是16:9。

       帧率：每秒的帧数(fps)或者说帧率表示图形处理器处理场时每秒钟能够更新的次数。

       码率： 数据传输时单位时间传送的数据位数,一般我们用的单位是kbps即千位每秒。

       素材：来自系统相机，其他App，电脑，网络的照片，音乐，视频等。

       视频分割： 把视频分割为若干个片段，可用于从视频中截取一个或者多个精彩瞬间，或者删除不喜欢的片段，分割后的多个片段也可以用于重新调整顺序，视频合并等。

       视频裁切： 从视频画面中裁切出来仅需要的部分，锐动视频编辑SDK针对手机竖屏拍摄的画面，支持动态调整裁切区域，帮助用户不同时间点选择自己需要的画面。

       视频旋转：对视频进行90°，180°，270°旋转，一般用于矫正用户手机上录制的头像横置的视频。

       视频镜像：对视频左右镜像。

       视频变速：对视频播放速度调整，实现慢镜头或者快镜头效果。

       视频配乐：选取本地或者网络音乐作为视频的背景音乐。

       视频配音：通过micphone对视频配音。

       视频字幕：使用文字标注视频。

       视频滤镜：调整视频的画面颜色效果。

       视频特效：在视频里面增加特效动画或声音

       合并转场：两个视频片段之间的衔接效果。

       主题（模版）： 应用视频的整体效果方案。

 

 

3 XCode集成步骤

 

3.1  运行环境

SDK支持Ios8.0及以上版本的设备，兼容iPhone、iPad、iPod touch

 

3.2 注册申请AppKey和APPSecret

1、 打开 http://www.rdsdk.com ，在锐动官网首页选择登 录或注册，新用户先注册，老用户直接登录。 

2、 登录完成后，进入视频云管理 点击“+新增”，填写您应 用的名称等，点击“提交”，应用创建完成。 

3、 创建应用完成后会自动跳转至个人中心页面，此时会获 取到该应用的 AppKey 和 AppSecret。

 

3.3 下载并导入SDK

3.3.1  添加静态库libRDVEUISDK.a和头文件

3.3.2  添加RDVEUISDK.bundle、RDVECore.bundle、VideoRecord.bundle

3.3.3  工程设置

l TARGETS的Deployment Info仅勾选竖屏(Portrait)，横屏(LandscapeLeft、LandscapeRight)不勾选：

 

l IOS10适配

在 Info.plist 中 添 加 NSCameraUsageDescription 、 

NSMicrophoneUsageDescription、NSPhotoLibraryUsageDescription、NSAppleMusicUsageDescription。 

 

l HTTP协议适配

在 Info.plist 中 添 加App Transport Security Settings

l 添加引用苹果官方库

如果录制时使用faceU，还需要引用库Accelerate.framework

l 设置 Other Linker Flags

在 TARGETS->Build Settings->Other Linker Flags 中加入-ObjC。 

l 设置Enable Bitcode

在 TARGETS->Build Settings->Enable Bitcode设置为No。

 

3.4 集成SDK

3.4.1 引入头文件及初始化

#import "RDVEUISDK.h"

/**  初始化对象

 *

 *  @param appkey          在锐动SDK官网(http://www.rdsdk.com/ )中注册的应用Key。

 *  @param appsecret       在锐动SDK官网(http://www.rdsdk.com/ )中注册的应用秘钥。

 *  @param licenceKey       在锐动SDK官网(http://www.rdsdk.com/ )中注册的licenceKey。

 *  @param resultFailBlock 返回错误信息

 */

- (instancetype) initWithAPPKey:(NSString *)appkey

                       APPSecret:(NSString *)appsecret

LicenceKey:(NSString *)licenceKey

                     resultFail:(RdVEFailBlock )resultFailBlock;

3.4.2 功能设置

/**   视频导出设置

 */

@property (nonatomic,strong) ExportConfiguration     *exportConfiguration;

 

/**   编辑设置

 */

@property (nonatomic,strong) EditConfiguration        * editConfiguration;

 

/**  拍摄功能设置

 */

@property (nonatomic,strong) CameraConfiguration    * cameraConfiguration;

 

3.4.2.1 视频导出设置

/** 设置视频输出最大时长 (单位是秒) 不限制则传0，默认不限制

 */

@property (nonatomic,assign)long int   outputVideoMaxDuration;

 

/** 设置视频输入最大时长 (单位是秒) 不限制则传0，默认不限制

 */

@property (nonatomic,assign)long int   inputVideoMaxDuration;

 

/** 是否禁用片尾

 */

@property (nonatomic,assign)bool    endPicDisabled;

 

/** 片尾显示的用户名

 */

@property (nonatomic,copy)NSString * _Nullable endPicUserName;

 

/** 片尾显示时长（不包括淡入时长）

 */

@property (nonatomic,assign)float    endPicDuration;

 

/** 片尾淡入时长

 */

@property (nonatomic,assign)float    endPicFadeDuration;

 

/** 片尾显示的图片路径

 */

@property (nonatomic,copy)NSString * _Nullable endPicImagepath;

 

/** 是否禁用水印

 */

@property (nonatomic,assign)bool     waterDisabled;

 

/** 文字水印

 */

@property (nonatomic,copy,nullable)NSString *waterText;

 

/** 图片水印

 */

@property (nonatomic,strong,nullable)UIImage *waterImage;

 

/** 显示位置

 */

@property (nonatomic,assign)RDWATERPOSITION  waterPosition;

 

/** 设置视频输出码率 (单位是兆,默认是6M),建议设置大于1M，导出和压缩都生效

 */

@property (nonatomic,assign)float   videoBitRate;

 

/**压缩视频分辨率（调用压缩视频接口生效）

 */

@property (nonatomic,assign)CGSize  condenseVideoResolutionRatio;

 

3.4.2.2 视频编辑设置

/** 向导模式 如果需要自己删除一些功能 则需启用此参数  default false

 */

@property (assign, nonatomic)bool enableWizard;

 

/** 编辑视频所支持的文件类型 (default all)

 */

@property (assign, nonatomic)SUPPORTFILETYPE supportFileType;

3.4.2.2.1 相册界面设置

/** 默认选中视频还是图片

 */

@property (nonatomic,assign) RDDEFAULTSELECTALBUM defaultSelectAlbum;

 

/**选择视频和图片的最大张数

 */

@property (nonatomic,assign) int mediaCountLimit;

 

/**选择视频和图片的最小数

 */

@property (nonatomic,assign) int mediaMinCount;

 

/**启用相册相机 (default true)

 */

@property (nonatomic,assign) bool enableAlbumCamera;

 

 

/**点击相册界面相机按钮回调

 */

@property (nonatomic,copy,nullable) void(^clickAlbumCameraBlackBlock)();

3.4.2.2.2 截取界面设置

/** 截取时间模式

 */

@property (nonatomic,assign) TRIMMODE trimMode;

 

/** 单个时间定长截取：截取时间 默认15s

 */

@property (nonatomic,assign) float trimDuration_OneSpecifyTime;

 

/** 两个时间定长截取：偏小截取时间 默认12s

 */

@property (nonatomic,assign) float trimMinDuration_TwoSpecifyTime;

 

/** 两个时间定长截取：偏大截取时间 默认30s

 */

@property (nonatomic,assign) float trimMaxDuration_TwoSpecifyTime;

 

/** 两个时间定长截取：默认选中小值还是大值

 */

@property (nonatomic,assign) RDdefaultSelectCutMinOrMax  defaultSelectMinOrMax;

 

/** 定长截取时，截取后视频分辨率类型 默认TRIMVIDEOTYPE_ORIGINAL

 *  自由截取时，始终为TRIMVIDEOTYPE_ORIGINAL，该设置无效

 */

@property (nonatomic,assign) TRIMEXPORTVIDEOTYPE trimExportVideoType;

3.4.2.2.3 编辑界面设置

/**单个媒体特效

  */

@property (nonatomic,assign) bool enableSingleSpecialEffects;

 

 

/** 单个媒体调色

 */

@property (nonatomic,assign) bool enableSingleMediaAdjust;

 

/** 单个媒体滤镜 (default true)

 */

@property (nonatomic,assign) bool enableSingleMediaFilter;

/** 截取 (default true)

 */

@property (nonatomic,assign) bool enableTrim;

 

/** 分割 (default true)

 */

@property (nonatomic,assign) bool enableSplit;

/** 裁切 (default true)

 */

@property (nonatomic,assign) bool enableEdit;

 

/** 变速 (default true)

 */

@property (nonatomic,assign) bool enableSpeedcontrol;

 

/** 复制 (default true)

 */

@property (nonatomic,assign) bool enableCopy;

 

/** 调整顺序 (default true)

 */

@property (nonatomic,assign) bool enableSort;

 

/** 调整视频比例 (default true)

 */

@property (nonatomic,assign) bool enableProportion;

 

/** 调整图片显示时长 (default true)

 */

@property (nonatomic,assign) bool enableImageDurationControl;

 

/** 文字版 (default true)

 */

@property (nonatomic,assign) bool enableTextTitle;

 

/** 默认视频输出方式（自动，横屏，1 ：1）

 */

@property (nonatomic,assign) RDPROPORTIONTYPE  proportionType;

 

/** 倒放 (default true)

 */

@property (nonatomic,assign) bool enableReverseVideo;

 

/** 草稿 (default false)

 */

@property (nonatomic,assign) bool enableDraft;

3.4.2.2.4 高级编辑界面设置

/** 网络素材分类地址

 */

@property (nonatomic,copy)NSString   * _Nonnull netMaterialTypeURL;

 

/** Music网络资源地址 (需自己构建网络下载API)

 */

@property (nonatomic,copy)NSString    * _Nullable musicResourceURL;

 

/** cloudMusic网络资源地址 (需自己构建网络下载API) default nil

 */

@property (nonatomic,copy)NSString    * _Nullable cloudMusicResourceURL;

/** 音效分类网络资源地址 (需自己构建网络下载API) default nil

 */

@property (nonatomic,copy)NSString    * _Nullable soundMusicTypeResourceURL;

 

/** 音效分类网络资源地址 (需自己构建网络下载API) default nil

 */

@property (nonatomic,copy)NSString    * _Nullable soundMusicResourceURL;

 

/** MV网络资源地址 (需自己构建网络下载API)

 */

@property (nonatomic,copy,nullable)NSString    *mvResourceURL;

 

/** MV网络资源地址

 */

@property (nonatomic,copy,nullable)NSString    *newmvResourceURL;

 

/** 音乐网络资源地址

 */

@property (nonatomic,copy,nullable)NSString    *newmusicResourceURL;

 

/** 音乐家

 */

@property (nonatomic,copy,nullable)NSString    *newartist;

 

/** 音乐家主页标题

 */

@property (nonatomic,copy,nullable)NSString    *newartistHomepageTitle;

 

/** 音乐家主页Url

 */

@property (nonatomic,copy,nullable)NSString    *newartistHomepageUrl;

 

/** 音乐授权证书标题

 */

@property (nonatomic,copy,nullable)NSString    *newmusicAuthorizationTitle;

 

/** 音乐授权证书Url

 */

@property (nonatomic,copy,nullable)NSString    *newmusicAuthorizationUrl;

 

/** 滤镜网络资源地址

 */

@property (nonatomic,copy,nullable)NSString    *filterResourceURL;

 

/** 字幕网络资源地址

 */

@property (nonatomic,copy,nullable)NSString    *subtitleResourceURL;

 

/** 贴纸网络资源地址

 */

@property (nonatomic,copy,nullable)NSString    *effectResourceURL;

 

/** 特效网络资源地址

 */

@property (nonatomic,copy,nullable)NSString    *specialEffectResourceURL;

 

/** 字体网络资源地址

 */

@property (nonatomic,copy,nullable)NSString    *fontResourceURL;

 

/** 转场网络资源地址

 */

@property (nonatomic,copy,nullable)NSString    *transitionURL;

 

/** 本地音乐 (default true)

 */

@property (nonatomic,assign) bool enableLocalMusic;

 

/** MV (default true)

 */

@property (nonatomic,assign) bool enableMV;

 

/** 配乐 (default true)

 */

@property (nonatomic,assign) bool enableMusic;

 

/** 变声 (default true)

 */

@property (nonatomic,assign) bool enableSoundEffect;

 

/** 配音 (default true)

 */

@property (nonatomic,assign) bool enableDubbing;

 

/** 转场 (default true)

 */

@property (nonatomic,assign) bool enableTransition;

 

/** 配音类型 (default 方式一(配音不放在配乐里面))

 */

@property (nonatomic,assign) RDDUBBINGTYPE dubbingType;

/** 字幕 (default true)

 */

@property (nonatomic,assign) bool enableSubtitle;

 

/** 滤镜 (default true)

 */

@property (nonatomic,assign) bool enableFilter;

 

/** 贴纸 (default true)

 */

@property (nonatomic,assign) bool enableSticker;

 

/** 特效 (default true)

 */

@property (nonatomic,assign) bool enableEffectsVideo;

 

/** 去水印 (default true)

 */

@property (nonatomic,assign) bool enableDewatermark;

 

/** 片段编辑 (default true)

 */

@property (nonatomic,assign) bool enableFragmentedit;

 

/** 图片动画 (default true)

 */

@property (nonatomic,assign) bool enablePicZoom;

 

/** 背景 (default true)

 */

@property (nonatomic,assign) bool enableBackgroundEdit;

 

/** 封面 (default true)

 */

@property (nonatomic,assign) bool enableCover;

/** 涂鸦 (default true)

 */

@property (nonatomic,assign) bool enableDoodle;

 

/** 进入SDK界面是否需要动画 (default true)

 */

@property (nonatomic,assign) bool presentAnimated;

 

/** 退出SDK界面是否需要动画 (default true)

 */

@property (nonatomic,assign) bool dissmissAnimated;

 

/** MVEffect (default false)

 */

@property (nonatomic,assign) bool enableMVEffect;

 

/** 画中画 (default true)

 */

@property (nonatomic,assign) bool enableCollage;

3.4.2.3 视频录制功能设置

/** 设置输出图像格式，默认为YES

 *  YES:kCVPixelFormatType_420YpCbCr8BiPlanarFullRange

 *  NO:kCVPixelFormatType_32BGRA

 */

@property(nonatomic, assign) bool captureAsYUV;

 

/** 拍摄模式 default CameraModel_Onlyone

 */

@property (nonatomic,assign) CameraModelType              cameraModelType;

 

/** 是否在拍摄完成就保存到相册再返回 default false 该参数只有在 CameraModel_Onlyone 模式下才生效

 */

@property (nonatomic,assign) bool                           cameraWriteToAlbum;

 

/** 前/后置摄像头 default AVCaptureDevicePositionFront

 */

@property (nonatomic,assign) AVCaptureDevicePosition        cameraCaptureDevicePosition;

 

/** 相机的方向 default RecordVideoOrientationAuto

 */

@property (nonatomic,assign) RecordVideoOrientation         cameraRecordOrientation;

 

/** 相机录制大小（正方形录制，非正方形录制）

 */

@property (nonatomic,assign) RecordVideoSizeType            cameraRecordSizeType;

 

/** 录制视频帧率 default 30

 */

@property (nonatomic,assign) int32_t                        cameraFrameRate;

 

/** 录制视频码率 default 4000000

 */

@property (nonatomic,assign) int32_t                        cameraBitRate;

 

/** 录制还是拍照 default RecordTypeVideo

 */

@property (nonatomic,assign) Record_Type                    cameraRecord_Type;

 

/** 视频输出路径

 */

@property (nonatomic,copy,nullable) NSString              *cameraOutputPath;

 

/**录制的视频的大小 (如：{720,1280}) default CGSizeZero

 */

@property (nonatomic,assign) CGSize                         cameraOutputSize;

 

/** 正方形录制时配置按钮的位置（美颜，延时，摄像头切换 三个按钮的位置）

 */

@property (nonatomic,assign) CameraCollocationPositionType  cameraCollocationPosition;

 

/** 正方形录制最大时长(default 10 )

 */

@property (nonatomic,assign) float                          cameraSquare_MaxVideoDuration;

 

/**非正方形录制最大时长 (default 0 ，不限制)

 */

@property (nonatomic,assign) float                          cameraNotSquare_MaxVideoDuration;

 

/**录制最小时长 (default 0 ，不限制 正方形录制和长方形录制都生效)

 */

@property (nonatomic,assign) float                          cameraMinVideoDuration;

 

/** 是否开启滤镜功能(只有在开启Faceu的时候该参数才生效)

 */

@property (nonatomic , assign) bool                         enableFilter;

 

/**人脸道具贴纸

 */

@property (assign, nonatomic) bool                          enableFaceU;

 

/**人脸道具贴纸证书

 */

@property (assign, nonatomic,nonnull) void                  *faceUAuth;

 

/**人脸道具贴纸证书长度

 */

@property (assign, nonatomic)Float64                        lenFaceUAuth;

 

/**是否启用网络下载faceUnity

 */

@property (assign, nonatomic)bool                           enableNetFaceUnity;

 

/**人脸道具贴纸下载路径

 */

@property (copy, nonatomic,nonnull)NSString                 *faceUURL;

 

/** 拍摄类型:可拍摄短视频MV(default true)

 */

@property (nonatomic,assign) bool                           cameraMV;

 

/** 拍摄类型:可拍摄视频(default true)

 */

@property (nonatomic,assign) bool                           cameraVideo;

 

/** 拍摄类型:可拍摄照片(default true)

 */

@property (nonatomic,assign) bool                           cameraPhoto;

 

/** 短视频MV录制最小时长(default 3s )

 */

@property (nonatomic,assign) float                          cameraMV_MinVideoDuration;

 

/** 短视频MV录制最大时长(default 15s )

 */

@property (nonatomic,assign) float                          cameraMV_MaxVideoDuration;

 

/** 从相机进入相册

 */

@property (nonatomic,copy,nonnull) void(^cameraEnterPhotoAlbumCallblackBlock)( );

 

/** 是否隐藏相机进入相册按钮

 */

@property (nonatomic,assign) bool                           hiddenPhotoLib;

 

// faceU美颜设置

/**瘦脸 0.0~1.0     default 0.68

 */

@property (nonatomic , assign) float cheekThinning;

 

 

/**大眼 0.0~2.0     default 1.53

 */

@property (nonatomic , assign) float eyeEnlarging;

 

 

/**美白 0.0~1.0     default 0.48

 */

@property (nonatomic , assign) float colorLevel;

 

/**磨皮 1 2 3 4 5   default 3

 */

@property (nonatomic , assign) float blurLevel;

 

/** 瘦脸等级 0.0 ~ 1.0 默认1.0

 */

@property (nonatomic , assign) float faceShapeLevel;

 

/** 瘦脸类型 0.0 ~ 3.0 默认0.0

 */

@property (nonatomic , assign) float faceShape;

 

/*是否开启使用音乐录制. 如果需要切换音乐请设置好音乐下载路径,不设置则跳转到本地音乐界面 （editConfiguration.cloudMusicResourceURL）

 */

@property (nonatomic, assign) BOOL                  enableUseMusic;

 

/*传入需要录制时播放的音乐

 */

@property (nonatomic, strong) RDMusicInfo          * _Nullable musicInfo;

 

/*是否启用相机水印

 */

@property (nonatomic, assign) BOOL              enabelCameraWaterMark;

/*片头水印时长

 */

@property (nonatomic, assign) float             cameraWaterMarkHeaderDuration;

 

/*片尾水印时长

 */

@property (nonatomic, assign) float             cameraWaterMarkEndDuration;

/*相机水印更新画面回调

 *1:正方形录制，0：非正方形录制*/

 */

@property (nonatomic, copy) void (^cameraWaterProcessingCompletionBlock)(NSInteger type,RecordStatus status, UIView *waterMarkview ,float time);

3.4.2.3.1 启用faceU说明

1、 导入签权证书

2、 导入美颜基础资源：face_beautification.bundle、v3.bundle

3.4.2.3.1.1  开启faceU

rdVESDK.cameraConfiguration.enableFaceU = true;

3.4.2.3.1.2  启用签权证书

    rdVESDK.cameraConfiguration.faceUAuth = &g_faceuAuth_package;

rdVESDK.cameraConfiguration.lenFaceUAuth = sizeof(g_faceuAuth_package);

3.4.2.3.1.3  从网络加载faceUnity道具资源

rdVESDK.cameraConfiguration.enableNetFaceUnity  = true;

rdVESDK.cameraConfiguration.faceUURL = @"http://faceUnity道具资源下载地址";

自定义获取faceUnity道具的url方法，具体参见《3.16.1自定义faceU资源》。

 

3.5 录制视频

/** 录制视频 参数设置(cameraConfiguration)

 *  @param source        源视图控制器

 *  @param callbackBlock 完成录制回调(result ：0 表示MV 1表示视频)

 *  @param imagebackBlock 拍照完成回调

 *  @param cancelBlock   取消录制回调

 */

- (void)videoRecordAutoSizeWithSourceController: (UIViewController*)source

                                  callbackBlock: (RdVERecordCallbackBlock)callbackBlock

                                 imagebackBlock: (RdVECallbackBlock)imagebackBlock

                                     faileBlock: (RdVEFailBlock)failBlock

        cancel: (RdVECancelBlock)cancelBlock;

 

3.6 编辑视频

/**   编辑短视频MV

 *

 *  @param viewController    源控制器

 *  @param urlAsset          视频源

 *  @param clipTimeRange     时间段

 *  @param crop              crop范围 默认:CGRectMake(0, 0, 1, 1)

 *  @param outputVideoPath   视频输出路径

 *  @param callbackBlock     完成编辑回调

 *  @param cancelBlock       取消编辑回调

 */

- (void)editVideoWithSuperController:(UIViewController *)viewController

                            urlAsset:(AVURLAsset *)urlAsset

                       clipTimeRange:(CMTimeRange )clipTimeRange

                                crop:(CGRect)crop

                          outputPath:(NSString *)outputVideoPath

                            callback:(RdVECallbackBlock )callbackBlock

cancel:(RdVECancelBlock )cancelBlock;

 

- (void)editVideoWithSuperController:(UIViewController *)viewController

                            urlAsset:(AVURLAsset *)urlAsset

                       clipTimeRange:(CMTimeRange )clipTimeRange

                                crop:(CGRect)crop

                           musicInfo:(RDMusicInfo *)musicInfo

                          outputPath:(NSString *)outputVideoPath

callback:(RdVECallbackBlock )callbackBlock

                        cancel:(RdVECancelBlock )cancelBlock;

 

/**   编辑视频(传入URL数组)

 *

 *  @param viewController    源控制器

 *  @param foldertype        缓存文件夹类型 （Documents、Library、Temp,None)

 *  @param appAlbumCacheName 需扫描的缓存文件夹名称

 *  @param urlsArray         视频/图片路径(NSMutableArray <NSURL*>)如：相册视频 assets-library://asset/asset...

 *  @param outputVideoPath   视频输出路径

 *  @param callbackBlock     完成编辑回调

 *  @param cancelBlock       取消编辑回调

 */

- (void)editVideoWithSuperController:(UIViewController *)viewController

                          foldertype:(FolderType)foldertype

                   appAlbumCacheName:(NSString *)appAlbumCacheName

                           urlsArray:(NSMutableArray *)urlsArray

                          outputPath:(NSString *)outputVideoPath

                            callback:(RdVECallbackBlock )callbackBlock

cancel:(RdVECancelBlock )cancelBlock;

 

- (void)editVideoWithSuperController:(UIViewController *)viewController

                          foldertype:(FolderType)foldertype

                   appAlbumCacheName:(NSString *)appAlbumCacheName

                           urlsArray:(NSMutableArray *)urlsArray

                           musicInfo:(RDMusicInfo *)musicInfo

                          outputPath:(NSString *)outputVideoPath

                            callback:(RdVECallbackBlock )callbackBlock

cancel:(RdVECancelBlock )cancelBlock;

/**   草稿箱

*/

- (void)editDraftWithSuperController:(UIViewController *)viewController

                          outputPath:(NSString *)outputVideoPath

                            callback:(RdVECallbackBlock)callbackBlock

                            failback:(RdVEFailBlock) failback

cancel:(RdVECancelBlock)cancelBlock;

 

 

3.7 自定义相册或是调用系统相册

实现代理方法：

/*

 *如果需要自定义相册则需要实现此函数

 */

- (void)selectVideoAndImageResult:(UINavigationController *)nav callbackBlock:(void (^)(NSMutableArray *lists))callbackBlock;

 

/*

 *如果需要自定义相册则需要实现此函数（添加视频）

 */

- (void)selectVideosResult:(UINavigationController *)nav callbackBlock:(void (^)(NSMutableArray *lists))callbackBlock;

/*

 *如果需要自定义相册则需要实现此函数（添加图片）

 */

- (void)selectImagesResult:(UINavigationController *)nav callbackBlock:(void (^)(NSMutableArray *lists))callbackBlock;

 

以系统相册为例：(需实现以下两个协议：UINavigationControllerDelegate, UIImagePickerControllerDelegate)

进入系统相册：

 

 

 

相册选择完成：

 

3.8 截取视频

/**  截取视频 通过传入视频对象 AVUrlAsset

 *  @param viewController               源控制器

 *  @param title                        导航栏标题

 *  @param backgroundColor              背景色

 *  @param cancelButtonTitle            取消按钮文字

 *  @param cancelButtonTitleColor       取消按钮标题颜色

 *  @param cancelButtonBackgroundColor  取消按钮背景色

 *  @param otherButtonTitle             完成按钮文字

 *  @param otherButtonTitleColor        完成按钮标题颜色

 *  @param otherButtonBackgroundColor   完成按钮背景色

 *  @param urlAsset                     数据源

 *  @param outputVideoPath              视频输出路径

 *  @param callbackBlock                截取完成回调

 *  @param failback                     截取失败回调

 *  @param cancelBlock                  取消截取回调

  */

- (void)trimVideoWithSuperController:(UIViewController *)viewController

                     controllerTitle:(NSString *) title

                     backgroundColor:(UIColor  *) backgroundColor

                   cancelButtonTitle:(NSString *) cancelButtonTitle

              cancelButtonTitleColor:(UIColor  *) cancelButtonTitleColor

         cancelButtonBackgroundColor:(UIColor  *) cancelButtonBackgroundColor

                    otherButtonTitle:(NSString *) otherButtonTitle

               otherButtonTitleColor:(UIColor  *) otherButtonTitleColor

          otherButtonBackgroundColor:(UIColor  *) otherButtonBackgroundColor

                            urlAsset:(AVURLAsset *) urlAsset

                          outputPath:(NSString *) outputVideoPath

                       callbackBlock:(RdVE_TrimAssetCallbackBlock) callbackBlock

                            failback:(RdVEFailBlock       ) failback

cancel:(RdVECancelBlock     ) cancelBlock;

/**  截取视频 通过传入路径 path

 *  @param viewController               源控制器

 *  @param title                        导航栏标题

 *  @param backgroundColor              背景色

 *  @param cancelButtonTitle            取消按钮文字

 *  @param cancelButtonTitleColor       取消按钮标题颜色

 *  @param cancelButtonBackgroundColor  取消按钮背景色

 *  @param otherButtonTitle             完成按钮文字

 *  @param otherButtonTitleColor        完成按钮标题颜色

 *  @param otherButtonBackgroundColor   完成按钮背景色

 *  @param assetPath                    数据源

 *  @param outputVideoPath              视频输出路径

 *  @param callbackBlock                截取完成回调

 *  @param failback                     截取失败回调

 *  @param cancelBlock                  取消截取回调

  */

- (void)trimVideoWithSuperController:(UIViewController *)viewController

                     controllerTitle:(NSString *) title

                     backgroundColor:(UIColor  *) backgroundColor

                   cancelButtonTitle:(NSString *) cancelButtonTitle

              cancelButtonTitleColor:(UIColor  *) cancelButtonTitleColor

         cancelButtonBackgroundColor:(UIColor  *) cancelButtonBackgroundColor

                    otherButtonTitle:(NSString *) otherButtonTitle

               otherButtonTitleColor:(UIColor  *) otherButtonTitleColor

          otherButtonBackgroundColor:(UIColor  *) otherButtonBackgroundColor

                           assetPath:(NSString *) assetPath

                          outputPath:(NSString *) outputVideoPath

                       callbackBlock:(RdVE_TrimVideoPathCallbackBlock) callbackBlock

                            failback:(RdVEFailBlock       ) failback

                              cancel:(RdVECancelBlock     ) cancelBlock;

 

/**设置截取返回类型

 * 此方法点击自定义弹框的按钮时才会被调用

 */

- (void)trimVideoWithType:(RDCutVideoReturnType )type;

 

/**截取视频 开始时间 总长

 */

- (void)Intercept:(NSString *)InPath

        atOutPath:(NSString *)OutPath

      atStartTime:(float) startTime

   atDurationTime:(float) DurationTime

         atAppkey:(NSString *)appKey

      atappSecret:(NSString *)appSecret

atvideoAverageBitRate:(float) videoAverageBitRate

atSuccessCancelBlock:(SuccessCancelBlock)successCancelBlock

atFailCancelBlock:(FailCancelBlock)failCancelBlock;

 

3.9 视频压缩

/**获取视频信息 字典 width height fps bitrate

 *

 */

- (NSDictionary *) getVideoInformation:(AVURLAsset *)urlAsset;

 

/** 压缩视频 参数设置(ExportConfiguration)

 *  @param size            压缩输出分辨率

 *  @param bitrate         压缩输出比特率

 *  @param progressBlock   压缩进度回调

 *  @param callbackBlock   压缩完成回调

 *  @param failBlock       压缩失败回调

 */

- (void)compressVideoAsset:(AVURLAsset *)urlAsset

                outputPath:(NSString *)outputPath

                 startTime:(CMTime )startTime

                   endTime:(CMTime )endTime

                outputSize:(CGSize) size

             outputBitrate:(float) bitrate

                supperView:(UIViewController *)supperView

             progressBlock:(void (^)(float progress))progressBlock

             callbackBlock:(void (^)(NSString *videoPath))callbackBlock

                      fail:(void (^)(NSError *error))failBlock;

/** 取消导出

 */

- (void) compressCancel;

 

3.10 照片电影

3.10.1 API实现(仿Quik)

- (void)pictureMovieWithSuperController_Theme:(UIViewController *)viewController

                                   UrlsArray:(NSMutableArray *)urlsArray

                                  outputPath:(NSString *)outputVideoPath

                                    callback:(RdVECallbackBlock )callbackBlock

                                      cancel:(RdVECancelBlock )cancelBlock;

3.10.2 AE模板

- (void)pictureMovieWithSuperController:(UIViewController *)viewController

                              UrlsArray:(NSMutableArray *)urlsArray

                             outputPath:(NSString *)outputVideoPath

                               callback:(RdVECallbackBlock )callbackBlock

                                 cancel:(RdVECancelBlock )cancelBlock;

 

3.11 创意搞怪小视频

3.11.1 AE模板(简影)

- (void)AEHomeWithSuperController:(UIViewController *)viewController

                       outputPath:(NSString *)outputVideoPath

                         callback:(RdVECallbackBlock )callbackBlock

                           cancel:(RdVECancelBlock )cancelBlock;

3.11.2 字说

- (void)aeTextAnimateWithSuperController:(UIViewController *)viewController

                              outputPath:(NSString *)outputVideoPath

                                callback:(RdVECallbackBlock )callbackBlock

                                  cancel:(RdVECancelBlock )cancelBlock;

 

 

3.12 多格

- (void)dogePuzzleWithSuperController:(UIViewController *)viewController

                                    UrlsArray:(NSMutableArray *)urlsArray

                                   outputPath:(NSString *)outputVideoPath

                                     callback:(RdVECallbackBlock )callbackBlock

cancel:(RdVECancelBlock )cancelBlock;

 

3.13 相册功能（选择视频或图片后返回选中资源）

/**选择视频或图片

 * @param viewController  源控制器

 * @param albumType 选择相册类型（仅选图片，仅选视频，两者皆可）

 * @param callbackBlock 相册选择完成返回一个NSURL数组 NSMutableArray <NSURL *> *List

 * @param cancelBlock 取消选择相册资源

 */

- (BOOL)onRdVEAlbumWithSuperController:(UIViewController *)viewController

                            albumType:(ALBUMTYPE)albumType

                            callBlock:(OnAlbumCallbackBlock) callbackBlock

                          cancelBlock:(RdVECancelBlock) cancelBlock;

 

3.14 导出视频中的音频

3.14.1 无界面

/** 从视频中提取音频

 *params: type                  输出音频类型，目前支持三种（AVFileTypeMPEGLayer3，AVFileTypeAppleM4A，AVFileTypeWAVE）

 *params: videoUrl              视频源地址

 *params: trimStart             从原始视频截取的开始时间 单位：秒 默认 0

 *params: duration              截取的持续时间 默认视频原始时长

 *params: outputFolder          输出文件存放的文件夹路径

 *params: samplerate            输出采样率

 *params: completionHandle      导出回调

 */

+ (void)video2audiowithtype:(AVFileType)type

                   videoUrl:(NSURL*)videoUrl

                  trimStart:(float)start

                   duration:(float)duration

           outputFolderPath:(NSString*)outputFolder

                 samplerate:(int )samplerate

                 completion:(void(^)(BOOL result,NSString*outputFilePath))completionHandle;

3.14.2 有界面

- (void)video2audiowithtype:(UIViewController *)viewController

               atAVFileType:(AVFileType)type

                   videoUrl:(NSURL*)videoUrl

           outputFolderPath:(NSString*)outputFolder

                 samplerate:(int )samplerate

                   callback:(RdVECallbackBlock )callbackBlock

cancel:(RdVECancelBlock )cancelBlock;

 

3.15 小功能

/** 单个媒体编辑

 *

 *  @param viewController    源控制器

 *  @param functionType      编辑类型

 *  @param urlArray          视频/图片路径如：相册视频 assets-library://asset/asset...

 *  @param outputVideoPath   视频输出路径

 *  @param callbackBlock     完成转码回调

 *  @param cancelBlock       取消转码回调

 */

- (void)singleMediaWithSuperController:(UIViewController *)viewController

                          functionType:(RDSingleFunctionType)functionType

                            outputPath:(NSString *)outputVideoPath

                              urlArray:(NSMutableArray <NSURL *>*)urlArray

                              callback:(RdVECallbackBlock)callbackBlock

                                cancel:(RdVECancelBlock)cancelBlock;

 

3.16 自定义资源

3.16.1 自定义faceU资源

获取人脸贴纸资源的 url 需满足以下定义:

请求格式：

参数说明：

正常返回结果：

设置访问http域名白名单：

3.16.2  自定义MV资源

1、通过以下配置启用 MV, 并设置获取 MV 资源的 url

rdVESDK.editConfiguration.enableMV = true;

rdVESDK.editConfiguration.mvResourceURL   = @"http://**";

2、MV中的json配置参照文件：素材管理平台操作手册.doc

3、获取 MV 资源的 url 需满足以下定义:

请求格式:

参数说明：

正常返回结果：

3.16.3  自定义配乐资源

通过以下配置启用自定义配乐 ,并设置获取配乐资源的 url

rdVESDK.editConfiguration.enableMusic = true;

rdVESDK.editConfiguration.musicResourceURL= @"http:// **"; //若不设置 url 自动隐藏该功能

获取配乐资源的 url 需满足以下定义:

请求格式:

参数说明：

正常返回结果：

3.16.4  自定义云音乐资源

通过以下配置启用自定义云音乐，并设置获取云音乐资源的 url

rdVESDK.editConfiguration.enableMusic = true;

rdVESDK.editConfiguration. soundMusicTypeResourceURL= @"http:// **";

rdVESDK.editConfiguration.cloudMusicResourceURL= @"http:// **";//若不设置 url 自动隐藏该功能 

获取云音乐资源的 url 需满足以下定义:

请求格式:

参数说明：

正常返回结果：

3.16.5 自定义字幕、贴纸资源

1、通过以下配置启用自定义字幕、贴纸，并设置获取字幕、贴纸资源的 url

rdVESDK.editConfiguration. enableSubtitle = true;

rdVESDK.editConfiguration. subtitleResourceURL= @"http:// **";//若不设置 url ，则使用默认地址

rdVESDK.editConfiguration. enableSticker= true;

rdVESDK.editConfiguration. effectResourceURL= @"http:// **";//若不设置 url ，则使用默认地址

2、json配置参照文件：素材管理平台操作手册.doc

3.16.6 自定义字体资源

1、设置获取字体资源的 url

rdVESDK.editConfiguration. fontResourceURL= @"http:// **";//若不设置 url ，则使用默认地址

3.16.7 自定义滤镜资源

1、通过以下配置启用自定义滤镜，并设置获取滤镜的 url

rdVESDK.editConfiguration. enableFilter= true;

rdVESDK.editConfiguration. filterResourceURL= @"http:// **";//若不设置 url ，则使用默认地址

3.16.8 自定义转场资源

1、通过以下配置启用自定义转场，并设置获取转场资源的 url

rdVESDK.editConfiguration. enableTransition= true;

rdVESDK.editConfiguration. transitionURL= @"http:// **";//若不设置 url ，则使用默认地址

3.16.9 自定义特效

1、通过以下配置启用自定义特效，并设置获取特效资源的 url

rdVESDK.editConfiguration. enableEffectsVideo = true;

rdVESDK.editConfiguration. specialEffectResourceURL = @"http:// **";//若不设置 url ，则使用默认地址

想要了解更多详细内容请联系QQ:45644590