/ZLPhotoBrowser

方便易用的相册多选框架,支持预览/相册内拍照、预览快速多选照片,3DTouch预览照片,编辑裁剪图片,编辑视频,混合多选image、gif、Live Photo及video;相册混合选择;原图功能;支持多语言国际化(中文简/繁,英语,日语);在线下载iCloud端图片;自定义最大选择量及最大预览量;自定义照片升序降序排列;自定义照片显示圆角弧度;支持预览网络及本地图片

Primary LanguageObjective-CMIT LicenseMIT

image

Version License Platform Language


框架整体介绍

功能介绍

  • 支持横竖屏
  • 预览快速选择、可设置预览最大数
  • 直接进入相册选择
  • 支持滑动多选
  • 裁剪图片(可自定义裁剪比例)
  • 编辑视频
  • 查看、选择gif、LivePhoto(iOS9.0)、video
  • 3D Touch预览image、gif、LivePhoto、video
  • 混合选择image、gif、livePhoto、video
  • 在线下载iCloud照片
  • 控制选择video最大时长
  • 多语言国际化(中文简/繁、英文、日文)
  • 相册内拍照按钮实时显示镜头捕捉画面
  • 已选择图片遮罩层标记
  • 预览已选择照片
  • 预览网络及本地照片
  • 相册内图片自定义圆角弧度
  • 自定义升序降序排列
  • 多张拍照

更新日志

● 2.4.2: 新增编辑视频功能;
● 2.4.1: 新增仿iPhone相册滑动多选功能;
● 2.4.0: 新增预览网络及本地图片api,并可进行选择删除;
● 2.3.3: 删除废弃文件,新增在已选择图片上显示遮罩层标记功能;
● 2.3.2: 新增设置导航颜色api,适配横屏,适配iPad;
● 2.2.9: 新增单选模式下选择图片后直接进入编辑界面功能,提供设置裁剪比例api;
● 2.2.8: 更新编辑图片功能,增加裁剪比例选项(1:1, 3:4, 2:3, 9:16,等比例,开发者可根据需求,按照规则自行添加所需比例);
● 2.2.6: ①:可混合选择image、gif、livephoto、video类型;
         ②:支持video、gif、livephoto类型的多选;
         ③:支持控制video最大选择时长;
● 2.2.3: 新增图片编辑功能;
● 2.2.1: 新增3D Touch预览功能 (需设备支持);
● 2.2.0: 优化内存问题;
● 2.1.9: 新增选择及预览Live Photo功能 (iOS 9.0);
● 2.1.7: 新增内部拍照按钮实时显示相机俘获画面功能;

框架支持

最低支持:iOS8.0

使用方法

第一步:

  • Manually
    • 1.直接把PhotoBrowser文件夹拖入到您的工程中
    • 2.导入 Photos.framework及PhotosUI.framework
    • 3.项目依赖 SDWebImage,所以需要导入该框架
    • 4.导入 "ZLPhotoActionSheet.h"
  • Cocoapods
    • 1.在Podfile 中添加 pod 'ZLPhotoBrowser'
    • 2.执行 pod setup
    • 3.执行 pod installpod update
    • 4.导入 <ZLPhotoActionSheet.h>

第二步:

  • 在项目plist配置文件中添加如下键,值并设为YES
//如果不添加该键值对,则不支持多语言,相册名称默认为英文

Localized resources can be mixed YES
//或者右键plist文件Open As->Source Code 添加
<key>CFBundleAllowMixedLocalizations</key>
<true/>

代码中调用

#import "ZLPhotoActionSheet.h"
    
ZLPhotoActionSheet *actionSheet = [[ZLPhotoActionSheet alloc] init];
//设置照片最大预览数
actionSheet.maxPreviewCount = 20;
//设置照片最大选择数
actionSheet.maxSelectCount = 10;
actionSheet.sender = self;

[actionSheet setSelectImageBlock:^(NSArray<UIImage *> * _Nonnull images, NSArray<PHAsset *> * _Nonnull assets, BOOL isOriginal) {
    //your codes
}];

[actionSheet showPreviewAnimated:YES];

问答

  • 关于 @available(9.0, *) 报错 (#90)

该错误会出现在XCode 9.0以下版本,把该代码替换为 [UIDevice currentDevice].systemVersion.floatValue >= 9.0 即可

效果图

  • 多语言国际化效果图 image image image image

  • 3DTouch预览效果图

image

  • 编辑视频预览图 image

  • 编辑图片预览图

image

  • 滑动多选预览图

image

  • 混合选择预览图

image

  • 横屏预览图

image

  • 预览网络图片

image

  • 遮罩层

image

  • 预览快速多选效果图

image image

  • 直接进入相册选择相片效果图

image

  • 预览大图及缩放效果图

image image image

  • 拍照

image

  • 相册内混合选择效果图

image

  • 预览已选择照片效果图

image image

  • 原图功能效果图

image