- 支持横竖屏 (已适配iPhone X)
- 预览快速选择、可设置预览最大数 (支持拖拽选择)
- 直接进入相册选择 (支持滑动多选)
- 裁剪图片 (可自定义裁剪比例)
- 编辑视频
- 查看、选择gif、LivePhoto(iOS9.0)、video
- 3D Touch预览image、gif、LivePhoto、video
- 混合选择image、gif、livePhoto、video
- 在线下载iCloud照片
- 控制选择video最大时长
- 多语言国际化 (中文简/繁、英文、日文,可设置跟随系统和自行切换,可自定义多语言提示)
- 相册内拍照按钮实时显示镜头捕捉画面
- 已选择图片遮罩层标记
- 预览已选择照片
- 预览网络及本地 图片/视频 (图片支持长按保存至相册)
- 相册内图片自定义圆角弧度
- 自定义升序降序排列
- 支持点击拍照及长按录制视频 (仿微信)
- 开发者可自定义资源图片
- 支持导出视频 (可指定导出视频尺寸、添加图片水印、粒子特效 ps:文字水印暂不支持)
如果您在使用中有好的需求及建议,或者遇到什么bug,欢迎随时issue,我会及时的回复
另外。。。求英语不错的大佬闲来无事、又心情好的时候,帮翻译一份英文版的README(更新日志、问答、效果图可不要)
● 2.6.3: 新增自定义多语言文本功能; 新增预览网络视频功能;
● 2.6.2: 新增是否保存已编辑图片的参数; 优化编辑图片旋转体验; 新增取消选择回调;
● 2.6.1: 新增导出视频添加粒子特效功能(如下雪特效); 新增编辑图片时旋转图片功能;
● 2.6.0: ①:新增调用系统相机录制视频功能;
②:支持导出指定尺寸的视频,支持导出视频添加图片水印;
③:优化部分UI显示;
● 2.5.5: 视频导出方法中添加压缩设置参数; 支持app名字国际化的获取; 删除视频导出3gp格式; fix #157;
● 2.5.4: 新增视频导出功能; 新增获取图片路径api; 优化自定义相机,当相机消失后恢复其他音乐软件的播放;
● 2.5.3: 拍摄视频及编辑视频支持多种格式(mov, mp4, 3gp); 新增相册名字等多语言,以完善手动设置语言时相册名字跟随系统的问题; 简化相册调用,configuration 由必传参数修改为非必传参数;
● 2.5.2: 提取相册配置参数独立为'ZLPhotoConfiguration'对象; 新增状态栏样式api; 优化部分代码;
● 2.5.1: ①:新增自定义相机(仿微信),开发者可选使用自定义相机或系统相机;
②:支持录制视频,可设置最大录制时长及清晰度;
● 2.5.0.2: 新增自行切换框架语言api; 编辑图片界面当只有一个比例且为custom或1:1状态下隐藏比例切换工具条;
● 2.5.0.1: 提供逐个解析图片api,方便 shouldAnialysisAsset 为 NO 时的使用; 提供控制是否可以选择原图参数;
● 2.5.0: 新增选择后是否自动解析图片参数 shouldAnialysisAsset (针对需要选择大量图片的功能,框架一次解析大量图片时,会导致内存瞬间大幅增高,建议此时置该参数为NO,然后拿到asset后自行逐个解析); 修改图片压缩方式,确保原图尺寸不变
● 2.4.9: 新增预览界面拖拽选择的功能; 支持开发者使用自定义图片资源; 开放导航标题颜色、底部工具栏背景色、底部按钮可交互与不可交互标题颜色的设置api;
● 2.4.6: 新增网络图片长按保存至相册功能;
● 2.4.3: 适配iPhone X,优化初次启动进入相册速度,预览网络图片可设置是否显示底部工具条及导航右侧按钮;
最低支持:iOS 8.0
IDE:Xcode 9.0 及以上版本 (由于适配iPhone X使用iOS11api,所以请使用Xcode 9.0及以上版本)
第一步:
- Manually
- 1.直接把PhotoBrowser文件夹拖入到您的工程中
- 2.导入 Photos.framework及PhotosUI.framework
- 3.项目依赖
SDWebImage
,所以需要导入该框架 - 4.导入 "ZLPhotoActionSheet.h"
- Cocoapods
- 1.在Podfile 中添加
pod 'ZLPhotoBrowser'
- 2.执行
pod setup
- 3.执行
pod install
或pod update
- 4.导入 <ZLPhotoActionSheet.h>
- 1.在Podfile 中添加
第二步:
- 在项目plist配置文件中添加如下键值对
//如果不添加该键值对,则不支持多语言,相册名称默认为英文
Localized resources can be mixed YES
//或者右键plist文件Open As->Source Code 添加
<key>CFBundleAllowMixedLocalizations</key>
<true/>
//相册使用权限描述
Privacy - Photo Library Usage Description
//相机使用权限描述
Privacy - Camera Usage Description
//麦克风使用权限描述
Privacy - Microphone Usage Description
代码中调用
#import "ZLPhotoActionSheet.h"
ZLPhotoActionSheet *ac = [[ZLPhotoActionSheet alloc] init];
//相册参数配置,configuration有默认值,可直接使用并对其属性进行修改
ac.configuration.maxSelectCount = 5;
ac.configuration.maxPreviewCount = 10;
//如调用的方法无sender参数,则该参数必传
ac.sender = self;
//选择回调
[ac setSelectImageBlock:^(NSArray<UIImage *> * _Nonnull images, NSArray<PHAsset *> * _Nonnull assets, BOOL isOriginal) {
//your codes
}];
//调用相册
[ac showPreviewAnimated:YES];
//预览网络图片
[ac previewPhotos:arrNetImages index:0 hideToolBar:YES complete:^(NSArray * _Nonnull photos) {
//your codes
}];
- 关于
@available(9.0, *)
报错 (#90)
该错误会出现在XCode 9.0以下版本,把该代码替换为
[UIDevice currentDevice].systemVersion.floatValue >= 9.0
即可
- 从
pod 2.4.3
以下版本更新到pod 2.4.3
以上版本报如下错误Terminating app due to uncaught exception 'NSUnknownKeyException', reason: '[<ZLThumbnailViewController 0x15bed0d10> setValue:forUndefinedKey:]: this class is not key value coding-compliant for the key verLeftSpace.'
由于
pod 2.4.3
版本删除对应xib,所以请执行command+shift+k
clean项目,重启Xcode即可
- 3DTouch预览效果图
- 导出视频添加粒子特效(雪花效果)
- 编辑视频预览图
- 编辑图片预览图
- 自定义相机效果图及介绍
- 滑动多选预览图
- 拖拽选择预览图
- 混合选择预览图
- 横屏预览图
- 预览网络图片
- 遮罩层
- 预览快速多选效果图
- 直接进入相册选择相片效果图
- 预览大图及缩放效果图
- 拍照
- 相册内混合选择效果图
- 预览已选择照片效果图
- 原图功能效果图