原理和使用
PHLivePhoto 是 iOS9.1开始的动态壁纸接口,它通过将静态图片和视频(mov格式),通过特定的编码,整合成PHLivePhoto实时照片对象.
WKCPhotoLiveView有四个初始化接口:
- 远程静图和远程视频.
/**
初始化
@param rpImageURL 远程图片
@param rMovURL 远程视频
@return 返回liveView
*/
- (instancetype)initWithRemotePlaceholdImageURL:(NSURL * _Nullable)rpImageURL
remoteMovURL:(NSURL * _Nonnull)rMovURL;
处理逻辑 : WKCDownloadManager和WKCImageLoader分别取下载视频和图片 -> 下载完成后,判断视频格式(mov格式,尝试合成livePhoto -> 合成成功则展示。合成失败,视频编码处理;非movWKCMovTransformer直接进行视频转码.) -> 视频转码过程中,WKCImageFramer获取一帧图片作为静态图片.
-> 视频转换完成,静图和mov合成livePhoto,通过PHLivePhotoView展示.
编码规则 :
1.1 静图需是mov的某帧图片.
1.2 视频需标记特殊的与静图对应的格式参数.WKCMovMaker获取mov的参数.
1.3 图片参数标记.WKCImageMaker,具体参数如下:
NSMutableDictionary * makerNote = [[NSMutableDictionary alloc] init];
[makerNote setObject:identify forKey:@"17"];
[metadata setObject:makerNote forKey:@"{MakerApple}"];
- 本地图片和远程视频
/**
初始化
@param fpImageName 本地图片
@param rMovURL 远程视频
@return 返回liveView
*/
- (instancetype)initWithFilePlaceholdImageName:(NSString * _Nullable)fpImageName
remoteMovURL:(NSURL * _Nonnull)rMovURL;
处理逻辑大致同上.具体详见WKCPhotoLiveView.
- 远程图片和本地视频.
/**
初始化
@param rpImageURL 远程图片
@param fMovURL 本地视频
@return 返回liveView
*/
- (instancetype)initWithRemotePlaceholdImageURL:(NSURL * _Nullable)rpImageURL
fileMovURL:(NSURL * _Nonnull)fMovURL;
- 本地图片和本地视频.
/**
初始化
@param fpImageName 本地图片
@param fMovURL 本地视频
@return 返回liveView
*/
- (instancetype)initWithFilePlaceholdImageName:(NSString * _Nullable)fpImageName
fileMovURL:(NSURL * _Nonnull)fMovURL;
其他属性和方法
/**
代理
*/
@property (nonatomic, weak) id delegate;
/**
展示模式 - 默认平铺
*/
@property (nonatomic, assign) UIViewContentMode liveMode;
/**
是否消音 - 默认NO
*/
@property (nonatomic, assign) BOOL muted;
/**
图片的存储位置 - 只读
*/
@property (nonatomic, copy, readonly) NSString * imageFile;
/**
video的存储位置 - 只读
*/
@property (nonatomic, copy, readonly) NSString * videoFile;
/**
重放
*/
- (void)replay;
/**
停止播放
*/
- (void)stopPlay;
/**
保存到图库
*/
- (void)saveToLibrary;
所有的事件回调均是通过代理完成的,代理方法如下:
@optional
/**
远程视频下载中...
@param liveView 当前视图
@param progress 下载进度
*/
- (void)wkcPhotoLiveView:(WKCPhotoLiveView *)liveView
downloadingProgress:(CGFloat)progress;
/**
远程视频结束...
@param liveView 当前视图
@param state 结束状态
*/
- (void)wkcPhotoLiveView:(WKCPhotoLiveView *)liveView
downloadedState:(WKCPhotoLiveDownloadedState)state;
/**
格式转换 - 非mov格式调用
@param liveView 当前视图
@param state 转换z状态
*/
- (void)wkcPhotoLiveView:(WKCPhotoLiveView *)liveView
transformState:(WKCMovTransformerState)state;
/**
点击当前视图
@param liveView 当前视图
*/
- (void)wkcPhotoLiveViewDidTouch:(WKCPhotoLiveView *)liveView;
/**
livePhoto将要播放
@param liveView 当前视图
*/
- (void)wkcPhotoLiveViewWillBeginPlay:(WKCPhotoLiveView *)liveView;
/**
livePhoto播放完毕
@param liveView 当前视图
*/
- (void)wkcPhotoLiveViewDidEndPlay:(WKCPhotoLiveView *)liveView;
/**
保存到图库
@param liveView 当前视图
@param state 保存状态
*/
- (void)wkcPhotoLiveView:(WKCPhotoLiveView *)liveView
saveToLibraryWithState:(WKCLivePhotoSaverState)state;
展示图.gif
.
如有bug或问题,请私信.github地址.