HXWeiboPhotoPicker - 仿微博照片选择器
如有遇到问题请先下载最新版
最新支持浏览网络图片
一. 特性 - Features
- 查看/选择GIF图片
- 照片、视频可同时多选/原图
- 3DTouch预览照片
- 长按拖动改变顺序
- 自定义相机拍照/录制视频
- 自定义转场动画
- 查看/选择LivePhoto IOS9.1以上才有用
- 支持浏览网络图片
二. 安装 - Installation
- Cocoapods:pod 'HXWeiboPhotoPicker' '~> 1.2' pod的版本为浏览网络图片之前的版本(不包含浏览网络图片)
- 手动导入:将项目中的“HXWeiboPhotoPicker”文件夹拖入项目中
- 只使用照片选择功能 导入头文件 "HXPhotoViewController.h"
- 选完照片/视频后自动布局功能 导入头文件 "HXPhotoView.h"
三. 要求 - Requirements
- iOS8及以上系统可使用. ARC环境. - iOS 8 or later. Requires ARC
- 在Xcode8环境下将项目运行在iOS10的设备/模拟器中,访问相册和相机需要配置两个info.plist文件。 Privacy - Photo Library Usage Description 和 Privacy - Camera Usage Description。
- 相机拍照功能请使用真机调试
四. 例子 - Examples
- HXPhotoManager 照片管理类相关属性介绍
显示全屏相机 // 默认 NO
showFullScreenCamera;
删除网络图片时是否显示Alert // 默认显示
showDeleteNetworkPhotoAlert;
网络图片地址数组
networkPhotoUrls
是否把相机功能放在外面 默认 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
/*
// 获取image - PHImageManagerMaximumSize 是原图尺寸 - 通过相册获取时有用 / 通过相机拍摄的无效
CGSize size = PHImageManagerMaximumSize; // 通过传入 size 的大小来控制图片的质量
[HXPhotoTools FetchPhotoForPHAsset:model.asset Size:size resizeMode:PHImageRequestOptionsResizeModeFast completion:^(UIImage *image, NSDictionary *info) {
NSLog(@"%@",image);
}];
// 这里的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);
}
*/
// 获取照片资源
[photos enumerateObjectsUsingBlock:^(HXPhotoModel *model, NSUInteger idx, BOOL * _Nonnull stop) {
// 小图 - 通过相机拍摄的照片才有值
model.thumbPhoto;
// 大图 - 通过相机拍摄的照片才有值
model.previewPhoto;
// 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;
// 视频封面 - 通过相机录制的视频才有值
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) {
// 通过相机拍摄的照片
if (model.networkPhotoUrl.length > 0) {
NSLog(@"网络图片");
}else {
NSLog(@"相机拍摄的照片");
}
}else if (model.type == HXPhotoModelMediaTypePhoto) {
// 相册里的照片
}else if (model.type == HXPhotoModelMediaTypePhotoGif) {
// 相册里的GIF图
}else if (model.type == HXPhotoModelMediaTypeLivePhoto) {
// 相册里的livePhoto
}
}];
五. 更新历史 - Update History
- 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的方法
- 2017-05-20 添加支持传入网络图片Url数组后进行浏览查看并删除
- 2017-05-24 修复传入网络图片之后添加按钮错误显示问题。添加全屏相机/开关控制
- 2017-06-02 修复在预览时取消选中时的问题
- 2017-06-26 因为潜在问题删除了一些快捷方法,需要自己写方法获取已选数组里照片的image和data
六. 更多 - More
-
如果您发现了bug请尽可能详细地描述系统版本、手机型号和复现步骤等信息 提一个issue.
-
如果您有什么好的建议也可以提issue,大家一起讨论一起学习进步...
-
具体代码请下载项目 如果觉得喜欢的能给一颗小星星么! ✨✨✨