- 查看/选择GIF图片
- 照片、视频可同时多选/原图
- 3DTouch预览照片
- 长按拖动改变顺序
- 自定义相机拍照/录制视频
- 自定义转场动画
- 查看/选择LivePhoto IOS9.1以上才有用
- 支持浏览网络图片
- 支持裁剪图片
- 观察系统相册变化实时增删
- 支持传入本地图片
- Cocoapods:
pod 'HXWeiboPhotoPicker' '~> 2.1.1'
搜索不到库或最新版请执行pod repo update
- 手动导入:将项目中的“HXWeiboPhotoPicker”文件夹拖入项目中
- 网络图片加载使用的是
SDWebImage v4.0.0
- 只使用照片选择功能 导入头文件 "HXPhotoViewController.h"
- 选完照片/视频后自动布局功能 导入头文件 "HXPhotoView.h"
- iOS8及以上系统可使用. ARC环境. - iOS 8 or later. Requires ARC
- 在Xcode8环境下将项目运行在iOS10的设备/模拟器中,访问相册和相机需要配置三个info.plist文件
- Privacy - Photo Library Usage Description 和 Privacy - Camera Usage Description 以及 Privacy - Microphone Usage Description
- 相机拍照功能请使用真机调试
- 2017-03-06 第一次提交
- 2017-03-07 修复通过相机拍照时照片旋转90°的问题
- ...
- 2017-06-26 合并一些方法、删除无用方法
- 2017-07-01 添加单选样式、支持裁剪图片
- 2017-07-05 解决同一界面多个选择器界面跳转问题,拍摄视频完成时遗留问题
- 2017-07-26 优化cell性能、3DTouch预览内存消耗。添加是否需要裁剪框属性、刷新界面方法以及拍照/选择照片完之后跳界面Demo
- 2017-08-08 添加国际化支持英文、保存拍摄的照片/视频到系统相册、实时监听系统相册变化并改变、缓存相册、选择视频时限制超过指定秒数不能选。以及一些小问题
- 2017-08-10 添加自定义属性、修复导航栏可能偏移64的问题
- 2017-08-12 添加系统相机、HXPhotoTools添加转换方法
- ...
- v2.0.5 - 修复相机拍照后显示错误,删除错误版本
- v2.0.6 - 修复ios8适配问题
- v2.0.7 - 支持传入本地图片、添加了一些属性和方法、优化了一些细节
- v2.0.8 - 修改一些细节问题、删除无效文件
- v2.0.9 - 添加一键将已选模型数组写入temp目录方法和新属性、demo示例
- v2.1.0 - 适配ios11以及iphone X / 3DTouch预览时播放gif、视频 / 优化区分icloud照片、修改写入文件方法
- v2.1.1 - 添加新相册风格(性能更好,支持横屏)、完善细节功能
- 2017-11-06 完善手势返回效果、修改小问题
// 将HXPhotoModel模型数组转化成HXPhotoResultModel模型数组 - 已按选择顺序排序
// !!!! 必须是全部类型的那个数组 就是 allList 这个数组 !!!!
[HXPhotoTools getSelectedListResultModel:allList complete:^(NSArray<HXPhotoResultModel *> *alls, NSArray<HXPhotoResultModel *> *photos, NSArray<HXPhotoResultModel *> *videos) {
NSSLog(@"\n全部类型:%@\n照片:%@\n视频:%@",alls,photos,videos);
}];
HXPhotoTools提供一个方法可以根据传入的模型数组转换成图片(UIImage)数组
type是个枚举
HXPhotoToolsFetchHDImageType = 0, // 高清
HXPhotoToolsFetchOriginalImageTpe, // 原图
[HXPhotoTools getImageForSelectedPhoto:photos type:HXPhotoToolsFetchHDImageType completion:^(NSArray<UIImage *> *images) {
NSSLog(@"%@",images);
for (UIImage *image in images) {
if (image.images.count > 0) {
// 到这里了说明这个image 是个gif图
}
}
}];
[self.view showLoadingHUDText:@"写入中"];
__weak typeof(self) weakSelf = self;
// 将选择的模型数组写入临时目录
[HXPhotoTools selectListWriteToTempPath:self.selectList completion:^(NSArray<NSURL *> *allUrl, NSArray<NSURL *> *imageUrls, NSArray<NSURL *> *videoUrls) {
NSSLog(@"\nall : %@ \nimage : %@ \nvideo : %@",allUrl,imageUrls,videoUrls);
[weakSelf.view handleLoading];
} error:^{
[weakSelf.view handleLoading];
[weakSelf.view showImageHUDText:@"写入失败"];
NSSLog(@"写入失败");
}];
// 懒加载 照片管理类
- (HXPhotoManager *)manager {
if (!_manager) {
_manager = [[HXPhotoManager alloc] initWithType:HXPhotoManagerSelectedTypePhotoAndVideo];
}
return _manager;
}
// 照片选择控制器
HXPhotoViewController *vc = [[HXPhotoViewController alloc] init];
vc.delegate = self;
vc.manager = self.manager;
[self presentViewController:[[UINavigationController alloc] initWithRootViewController:vc] animated:YES completion:nil];
// 通过 HXPhotoViewControllerDelegate 代理返回选择的图片以及视频
- (void)photoViewControllerDidNext:(NSArray *)allList Photos:(NSArray *)photos Videos:(NSArray *)videos Original:(BOOL)original
// 点击取消
- (void)photoViewControllerDidCancel
// 懒加载 照片管理类
- (HXPhotoManager *)manager {
if (!_manager) {
_manager = [[HXPhotoManager alloc] initWithType:HXPhotoManagerSelectedTypePhotoAndVideo];
}
return _manager;
}
self.navigationController.navigationBar.translucent = NO;
self.automaticallyAdjustsScrollViewInsets = YES;
HXPhotoView *photoView = [[HXPhotoView alloc] initWithFrame:CGRectMake((414 - 375) / 2, 100, 375, 400) manager:self.manager];
photoView.delegate = self;
photoView.backgroundColor = [UIColor whiteColor];
[self.view addSubview:photoView];
// 代理返回 选择、移动顺序、删除之后的图片以及视频
- (void)photoView:(HXPhotoView *)photoView changeComplete:(NSArray<HXPhotoModel *> *)allList photos:(NSArray<HXPhotoModel *> *)photos videos:(NSArray<HXPhotoModel *> *)videos original:(BOOL)isOriginal;
// 当view更新高度时调用
- (void)photoView:(HXPhotoView *)photoView updateFrame:(CGRect)frame;
// 删除网络图片的地址
- (void)photoView:(HXPhotoView *)photoView deleteNetworkPhoto:(NSString *)networkPhotoUrl;
// 网络图片全部下载完成时调用
- (void)photoViewAllNetworkingPhotoDownloadComplete:(HXPhotoView *)photoView;
- (HXPhotoManager *)manager { // 懒加载管理类
if (!_manager) { // 设置一些配置信息
_manager = [[HXPhotoManager alloc] initWithType:HXPhotoManagerSelectedTypePhoto];
// _manager.openCamera = NO;
_manager.outerCamera = YES;
_manager.showDeleteNetworkPhotoAlert = NO;
_manager.saveSystemAblum = YES;
_manager.photoMaxNum = 2; // 这里需要注意 !!! 第一次传入的最大照片数 是可选最大数 减去 网络照片数量 即 photoMaxNum = maxNum - networkPhotoUrls.count 当点击删除网络照片时, photoMaxNum 内部会自动加1
_manager.videoMaxNum = 0; // 如果有网络图片且选择类型为HXPhotoManagerSelectedTypePhotoAndVideo 又设置了视频最大数且不为0时,
// 那么在选择照片列表最大只能选择 photoMaxNum + videoMaxNum
// 在外面collectionView上最大数是 photoMaxNum + networkPhotoUrls.count + videoMaxNum
_manager.maxNum = 6;
// 可以这个赋值也可以像下面那样
// _manager.networkPhotoUrls = [NSMutableArray arrayWithObjects:@"http://tsnrhapp.oss-cn-hangzhou.aliyuncs.com/003d86db-b140-4162-aafa-d38056742181.jpg",@"http://tsnrhapp.oss-cn-hangzhou.aliyuncs.com/0034821a-6815-4d64-b0f2-09103d62630d.jpg",@"http://tsnrhapp.oss-cn-hangzhou.aliyuncs.com/0be5118d-f550-403e-8e5c-6d0badb53648.jpg",@"http://tsnrhapp.oss-cn-hangzhou.aliyuncs.com/1466408576222.jpg", nil];
}
return _manager;
}
CGFloat width = scrollView.frame.size.width;
HXPhotoView *photoView = [HXPhotoView photoManager:self.manager];
photoView.frame = CGRectMake(kPhotoViewMargin, kPhotoViewMargin, width - kPhotoViewMargin * 2, 0);
photoView.delegate = self;
photoView.backgroundColor = [UIColor whiteColor];
[scrollView addSubview:photoView];
self.photoView = photoView;
// 可以在懒加载中赋值 , 也可以这样赋值
self.manager.networkPhotoUrls = [NSMutableArray arrayWithObjects:@"http://oss-cn-hangzhou.aliyuncs.com/tsnrhapp/shop/photos/857980fd0acd3caf9e258e42788e38f5_0.gif",@"http://tsnrhapp.oss-cn-hangzhou.aliyuncs.com/0034821a-6815-4d64-b0f2-09103d62630d.jpg",@"http://tsnrhapp.oss-cn-hangzhou.aliyuncs.com/0be5118d-f550-403e-8e5c-6d0badb53648.jpg",@"http://tsnrhapp.oss-cn-hangzhou.aliyuncs.com/1466408576222.jpg", nil];
// 设置完网络图片地址数组后重新给manager赋值
photoView.manager = self.manager;
- (HXPhotoManager *)manager {
if (!_manager) {
_manager = [[HXPhotoManager alloc] initWithType:HXPhotoManagerSelectedTypePhoto];
_manager.openCamera = YES;
// 在这里设置为单选模式
_manager.singleSelected = YES;
// 设置是否需要裁剪功能
_manager.singleSelecteClip = NO;
_manager.cameraType = HXPhotoManagerCameraTypeFullScreen;
}
return _manager;
}
HXPhotoViewController *vc = [[HXPhotoViewController alloc] init];
vc.manager = self.manager;
vc.delegate = self;
[self presentViewController:[[UINavigationController alloc] initWithRootViewController:vc] animated:YES completion:nil];
// 代理返回选择的结果
- (void)photoViewControllerDidNext:(NSArray<HXPhotoModel *> *)allList Photos:(NSArray<HXPhotoModel *> *)photos Videos:(NSArray<HXPhotoModel *> *)videos Original:(BOOL)original {
__weak typeof(self) weakSelf = self;
// 这里使用HXPhotoTools 里面的方法获取image
[HXPhotoTools getImageForSelectedPhoto:photos type:0 completion:^(NSArray<UIImage *> *images) {
weakSelf.imageView.image = images.firstObject;
}];
}
// 懒加载三个管理类用来控制三个选择器
- (HXPhotoManager *)oneManager {
if (!_oneManager) {
_oneManager = [[HXPhotoManager alloc] initWithType:HXPhotoManagerSelectedTypePhoto];
}
return _oneManager;
}
- (HXPhotoManager *)twoManager {
if (!_twoManager) {
_twoManager = [[HXPhotoManager alloc] initWithType:HXPhotoManagerSelectedTypeVideo];
}
return _twoManager;
}
- (HXPhotoManager *)threeManager {
if (!_threeManager) {
_threeManager = [[HXPhotoManager alloc] initWithType:HXPhotoManagerSelectedTypePhotoAndVideo];
}
return _threeManager;
}
// 初始化UIScrollerView以及三个HXPhotoView
self.scrollView = [[UIScrollView alloc] initWithFrame:CGRectMake(0, 0, self.view.frame.size.width, self.view.frame.size.height)];
self.scrollView.alwaysBounceVertical = YES;
[self.view addSubview:self.scrollView];
self.onePhotoView = [[HXPhotoView alloc] initWithFrame:CGRectMake(kPhotoViewMargin, kPhotoViewMargin, self.view.frame.size.width - kPhotoViewMargin * 2, 0) WithManager:self.oneManager];
self.onePhotoView.delegate = self;
[self.scrollView addSubview:self.onePhotoView];
self.twoPhotoView = [[HXPhotoView alloc] initWithFrame:CGRectMake(kPhotoViewMargin, CGRectGetMaxY(self.onePhotoView.frame) + kPhotoViewSectionMargin, self.view.frame.size.width - kPhotoViewMargin * 2, 0) WithManager:self.twoManager];
self.twoPhotoView.delegate = self;
[self.scrollView addSubview:self.twoPhotoView];
self.threePhotoView = [[HXPhotoView alloc] initWithFrame:CGRectMake(kPhotoViewMargin, CGRectGetMaxY(self.twoPhotoView.frame) + kPhotoViewSectionMargin, self.view.frame.size.width - kPhotoViewMargin * 2, 0) WithManager:self.threeManager];
self.threePhotoView.delegate = self;
[self.scrollView addSubview:self.threePhotoView];
// 根据photoView来判断是哪一个选择器
- (void)photoView:(HXPhotoView *)photoView changeComplete:(NSArray<HXPhotoModel *> *)allList photos:(NSArray<HXPhotoModel *> *)photos videos:(NSArray<HXPhotoModel *> *)videos original:(BOOL)isOriginal {
if (self.onePhotoView == photoView) {
NSSLog(@"onePhotoView - %@",allList);
}else if (self.twoPhotoView == photoView) {
NSSLog(@"twoPhotoView - %@",allList);
}else if (self.threePhotoView == photoView) {
NSSLog(@"threePhotoView - %@",allList);
}
}
// 返回更新后的frame,根据photoView来更新scrollView
- (void)photoView:(HXPhotoView *)photoView updateFrame:(CGRect)frame {
if (self.onePhotoView == photoView) {
self.twoPhotoView.frame = CGRectMake(kPhotoViewMargin, CGRectGetMaxY(self.onePhotoView.frame) + kPhotoViewSectionMargin, self.view.frame.size.width - kPhotoViewMargin * 2, self.twoPhotoView.frame.size.height);
self.threePhotoView.frame = CGRectMake(kPhotoViewMargin, CGRectGetMaxY(self.twoPhotoView.frame) + kPhotoViewSectionMargin, self.view.frame.size.width - kPhotoViewMargin * 2, self.threePhotoView.frame.size.height);
}else if (self.twoPhotoView == photoView) {
self.twoPhotoView.frame = CGRectMake(kPhotoViewMargin, CGRectGetMaxY(self.onePhotoView.frame) + kPhotoViewSectionMargin, self.view.frame.size.width - kPhotoViewMargin * 2, self.twoPhotoView.frame.size.height);
self.threePhotoView.frame = CGRectMake(kPhotoViewMargin, CGRectGetMaxY(self.twoPhotoView.frame) + kPhotoViewSectionMargin, self.view.frame.size.width - kPhotoViewMargin * 2, self.threePhotoView.frame.size.height);
}else if (self.threePhotoView == photoView) {
self.threePhotoView.frame = CGRectMake(kPhotoViewMargin, CGRectGetMaxY(self.twoPhotoView.frame) + kPhotoViewSectionMargin, self.view.frame.size.width - kPhotoViewMargin * 2, frame.size.height);
}
self.scrollView.contentSize = CGSizeMake(self.view.frame.size.width, CGRectGetMaxY(self.threePhotoView.frame) + kPhotoViewMargin);
}
// 先在第一个控制器里初始化管理类并设置好属性
- (HXPhotoManager *)manager {
if (!_manager) {
/** 注意!!! 如果是先选照片拍摄的话, 不支持将拍摄的照片或者视频保存到系统相册 **/
_manager = [[HXPhotoManager alloc] initWithType:HXPhotoManagerSelectedTypePhotoAndVideo];
_manager.outerCamera = YES;
_manager.openCamera = NO;
_manager.saveSystemAblum = YES;
}
return _manager;
}
// 通过HXPhotoViewController的代理跳转界面并将当前界面的管理类传入下一个界面
- (void)photoViewControllerDidNext:(NSArray<HXPhotoModel *> *)allList Photos:(NSArray<HXPhotoModel *> *)photos Videos:(NSArray<HXPhotoModel *> *)videos Original:(BOOL)original {
Demo6SubViewController *vc = [[Demo6SubViewController alloc] init];
vc.manager = self.manager;
[self.navigationController pushViewController:vc animated:YES];
}
// 这里需要注意在第二个控制释放的时候需要将已选的操作清空
- (void)dealloc {
[self.manager clearSelectedList];
}
// 加载本地图片
NSMutableArray *images = [NSMutableArray array];
for (int i = 0 ; i < 4; i++) {
UIImage *image = [UIImage imageNamed:[NSString stringWithFormat:@"%d",i]];
[images addObject:image];
}
CGFloat width = scrollView.frame.size.width;
HXPhotoView *photoView = [[HXPhotoView alloc] initWithFrame:CGRectMake(kPhotoViewMargin, kPhotoViewMargin, width - kPhotoViewMargin * 2, 0) manager:self.manager];
photoView.delegate = self;
photoView.backgroundColor = [UIColor whiteColor];
// 在这里将本地图片image数组给管理类并且刷新界面
self.manager.localImageList = images;
[photoView refreshView];
[scrollView addSubview:photoView];
self.photoView = photoView;
-
如果您发现了bug请尽可能详细地描述系统版本、手机型号和复现步骤等信息 提一个issue.
-
如果您有什么好的建议也可以提issue,大家一起讨论一起学习进步...
-
具体代码请下载项目 如果觉得喜欢的能给一颗小星星么! ✨✨✨