- 查看/选择GIF图片
- 照片、视频可同时多选/原图
- 3DTouch预览照片
- 长按拖动改变顺序
- 自定义相机拍照/录制视频
- 自定义转场动画
- 查看/选择LivePhoto IOS9以上才有用
- Cocoapods：pod 'HXWeiboPhotoPicker' '~> 1.2'
- 如果 pod search 不到请把项目里podsearch文件夹里的 ‘HXWeiboPhotoPicker’ 文件夹复制到 /Users/‘这里是你的用户 名’/.cocoapods/repos/master/Specs/f/5/e 这个路径里,然后在终端执行 rm ~/Library/Caches/CocoaPods/search_index.json 然后再 pod search HXWeiboPhotoPicker
- 手动导入：将项目中的“HXWeiboPhotoPicker”文件夹拖入项目中
- 只使用照片选择功能 导入头文件 "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。
- 相机拍照功能请使用真机调试
!关于为什么照片模型里面只有 thumbPhoto 这个才有值
为了优化相册列表以及预览大图列表快速滑动内存暴增的问题，
如果缓存了imageData或者原图的image,用户图片过多时这会导致内存的增大,
而且当快速滑动遇到图片过大时可能导致滑动卡顿 / 内存警告⚠️程序被杀。
故不缓存imageData和image 只保留 thumbPhoto 缩略图
这样可以保证在选择照片/快速滑动过程中,不会因为内存过大导致程序被杀 和 滑动流畅丝滑。
所以要获取已选图片的原图可以选择HXPhotoTools提供的快速获取已选照片的全部原图 或
快速获取已选照片的全图高清图片,获取高清图片消耗内存很小而且图片质量也很高
当然您也可以自己根据指定方法控制传入的size来获取不同质量的图片。
提醒：在用户没有选择原图的时候不要使用原图上传，获取image时size稍微缩小一点这样可以保证上传快内存消耗小一点。
在使用快速获取原图方法时,请将这个方法写在上传方法里! 在获取原图Image的过程中会比较消耗内存.
- HXPhotoManager 照片管理类相关属性介绍
是否把相机功能放在外面 默认 NO 使用 HXPhotoView 时有用
outerCamera;
是否打开相机功能
openCamera;
是否开启查看GIF图片功能 - 默认开启
lookGifPhoto;
是否开启查看LivePhoto功能呢 - 默认开启
lookLivePhoto;
是否一开始就进入相机界面
goCamera;
最大选择数 默认10 - 必填
maxNum;
图片最大选择数 默认9 - 必填
photoMaxNum;
视频最大选择数 默认1 - 必填
videoMaxNum;
图片和视频是否能够同时选择 默认支持
selectTogether;
相册列表每行多少个照片 默认4个
rowCount;
- Demo1
// 懒加载 照片管理类
- (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
- Demo2
// 懒加载 照片管理类
- (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) WithManager:self.manager];
photoView.delegate = self;
photoView.backgroundColor = [UIColor whiteColor];
[self.view addSubview:photoView];
// 通过 HXPhotoViewDelegate 代理返回 选择、移动顺序、删除之后的图片以及视频
- (void)photoViewChangeComplete:(NSArray *)allList Photos:(NSArray *)photos Videos:(NSArray *)videos Original:(BOOL)isOriginal
// 当 HXPhotoView 更新frame改变大小时
- (void)photoViewUpdateFrame:(CGRect)frame WithView:(UIView *)view
- 关于通过 HXPhotoModel 获取照片/视频信息的使用介绍 具体代码还是请下载Demo
// 获取数组里面图片的 HD(高清)图片 传入的数组里装的是 HXPhotoModel -- 这个方法必须写在点击上传的位置
[HXPhotoTools fetchHDImageForSelectedPhoto:photos completion:^(NSArray<UIImage *> *images) {
NSLog(@"%@",images);
}];
/*
如果真的觉得这个方法获取的高清图片还达不到你想要的效果,你可以按住 command 点击上面方法修改以下属性来获取你想要的图片
// 这里的size 是普通图片的时候 想要更高质量的图片 可以把 1.5 换成 2 或者 3
如果觉得内存消耗过大可以 调小一点
CGSize size = CGSizeMake(model.endImageSize.width * 1.5, model.endImageSize.height * 1.5);
// 这里是判断图片是否过长,因为图片如果长了上面的size就显的有点小了获取出来的图片就变模糊了,
所以这里把宽度 换成了屏幕的宽度,这个可以保证即不影响内存也不影响质量
如果觉得质量达不到你的要求,可以乘上 1.5 或者 2 .
当然你也可以不按我这样给size,自己测试怎么给都可以
if (model.endImageSize.height > model.endImageSize.width / 9 * 20) {
size = CGSizeMake([UIScreen mainScreen].bounds.size.width, model.endImageSize.height);
}
*/
// 获取数组里面图片的 ImageData 资源 传入的数组里装的是 HXPhotoModel -- 这个方法请写在点击上传的位置
[HXPhotoTools fetchImageDataForSelectedPhoto:photos completion:^(NSArray<NSData *> *imageDatas) {
NSLog(@"%ld",imageDatas.count);
}];
// 获取数组里面图片的原图 传入的数组里装的是 HXPhotoModel -- 这个方法必须写在点击上传的地方获取 此方法比较消耗内存. 获取原图图片之后请将选中数组中模型里面的数据全部清空 建议使用获取imageData方法
[HXPhotoTools fetchOriginalForSelectedPhoto:photos completion:^(NSArray<UIImage *> *images) {
NSLog(@"%@",images);
}];
// 获取照片资源
[photos enumerateObjectsUsingBlock:^(HXPhotoModel *model, NSUInteger idx, BOOL * _Nonnull stop) {
// 小图 - 这个字段会一直有值
model.thumbPhoto;
// 大图 - 这个字段没有值 - 如果是通过相机拍照的这个字段一直有值跟 thumbPhoto 是一样的
model.previewPhoto;
// imageData - 这个字段没有值
model.imageData;
// livePhoto - 这个字段只有当查看过livePhoto之后才会有值
model.livePhoto;
// isCloseLivePhoto 判断当前图片是否关闭了 livePhoto 功能 YES-关闭 NO-开启
model.isCloseLivePhoto;
// 获取imageData - 通过相册获取时有用 / 通过相机拍摄的无效
[HXPhotoTools FetchPhotoDataForPHAsset:model.asset completion:^(NSData *imageData, NSDictionary *info) {
NSLog(@"%@",imageData);
}];
// 获取image - PHImageManagerMaximumSize 是原图尺寸 - 通过相册获取时有用 / 通过相机拍摄的无效
CGSize size = PHImageManagerMaximumSize; // 通过传入 size 的大小来控制图片的质量
[HXPhotoTools FetchPhotoForPHAsset:model.asset Size:size resizeMode:PHImageRequestOptionsResizeModeFast completion:^(UIImage *image, NSDictionary *info) {
NSLog(@"%@",image);
}];
// 如果是通过相机拍摄的照片只有 thumbPhoto、previewPhoto和imageSize 这三个字段有用可以通过 type 这个字段判断是不是通过相机拍摄的
if (model.type == HXPhotoModelMediaTypeCameraPhoto);
}];
// 如果是相册选取的视频 要获取视频URL 必须先将视频压缩写入文件,得到的文件路径就是视频的URL 如果是通过相机录制的视频那么 videoURL 这个字段就是视频的URL 可以看需求看要不要压缩
[videos enumerateObjectsUsingBlock:^(HXPhotoModel *model, NSUInteger idx, BOOL * _Nonnull stop) {
// 视频封面
model.thumbPhoto;
// previewPhoto 这个也是视频封面 如果是在相册选择的视频 这个字段有可能没有值,只有当用户通过3DTouch 预览过之后才会有值 而且比 thumbPhoto 清晰 如果视频是通过相机拍摄的视频 那么 previewPhoto 这个字段跟 thumbPhoto 是同一张图片也是比较清晰的
model.previewPhoto;
// 如果是通过相机录制的视频 需要通过 model.VideoURL 这个字段来压缩写入文件
if (model.type == HXPhotoModelMediaTypeCameraVideo) {
[self compressedVideoWithURL:model.videoURL success:^(NSString *fileName) {
NSLog(@"%@",fileName); // 视频路径也是视频URL;
} failure:^{
// 压缩写入失败
}];
}else { // 如果是在相册里面选择的视频就需要用过 model.avAsset 这个字段来压缩写入文件
[self compressedVideoWithURL:model.avAsset success:^(NSString *fileName) {
NSLog(@"%@",fileName); // 视频路径也是视频URL;
} failure:^{
// 压缩写入失败
}];
}
}];
// 判断照片、视频 或 是否是通过相机拍摄的
[allList enumerateObjectsUsingBlock:^(HXPhotoModel *model, NSUInteger idx, BOOL * _Nonnull stop) {
if (model.type == HXPhotoModelMediaTypeCameraVideo) {
// 通过相机录制的视频
}else if (model.type == HXPhotoModelMediaTypeCameraPhoto) {
// 通过相机拍摄的照片
}else if (model.type == HXPhotoModelMediaTypePhoto) {
// 相册里的照片
}else if (model.type == HXPhotoModelMediaTypePhotoGif) {
// 相册里的GIF图
}else if (model.type == HXPhotoModelMediaTypeLivePhoto) {
// 相册里的livePhoto
}
}];
- 2017-03-07 修复通过相机拍照时照片旋转90°的问题
- 2017-03-08 修复拍照之后,在浏览大图时选中图片,列表界面Cell没有选中的问题
- 2017-03-09 添加查看 LivePhoto 功能、是否查看GIF图和LivePhoto的控制开关,修复Cell重复注册3DTouch功能导致内存一直增加问题
- 2017-03-10 添加控制是否开启相机功能的开关 以及 控制相机功能是否内/外置开关.
- 2017-03-11 通过相机拍照和录制视频之后的长照片、长视频裁剪成正方形以及修复一些小问题
- 2017-03-13 修复自定义相机bug、优化相机照片访问权限问题
- 2017-03-22 修复最大数限制问题
- 2017-03-29 解决裁剪视频时声音丢失问题、优化了快速滑动内存问题、添加获取选中数组里面图片的原图和imageData的方法
-
如果您发现了bug请尽可能详细地描述系统版本、手机型号和复现步骤等信息 提一个issue.
-
如果您有什么好的建议也可以提issue,大家一起讨论一起学习进步...
-
具体代码请下载项目 如果觉得喜欢的能给一颗小星星么! ✨✨✨
-
QQ : 294005139