GKPhotoBrowser是一个可高度自定义的图片、视频浏览器,支持多种显示、隐藏方式,支持自定义遮罩等
如果在使用过程中遇到问题,请先检查使用的版本是否是最新版本(可在说明最上面的pod后面查看),如果不是最新版本,请先更新到最后版本,看看问题是否存在,如果依然存在,可提issue说明或加我QQ1094887059直接问我,最好能提供demo。
- 支持图片浏览、视频播放、图片视频混排等
- 支持iPhone、iPad
- 支持单击、双击、长按手势,支持滑动缩放
- 支持多种显示方式(none,zoom,push)
- 支持多种隐藏方式(zoom,zoomScale,zoomSlide)
- 支持多种加载方式(不明确、不明确带阴影、明确进度)
- 支持自定义遮罩视图
- 支持屏幕旋转
- 支持gif图片加载
- 支持livePhoto加载播放
- 支持自定义图片加载、视频播放、livePhoto下载、进度显示等功能
- 支持Swift
默认安装,支持图片(SDWebImage加载)、视频(AVPlayer播放)、livePhoto(AFNetworking下载)
pod 'GKPhotoBrowser' 或 pod 'GKPhotoBrowser/Default'
基础库
pod 'GKPhotoBrowser/Core'
SDWebImage加载图片
pod 'GKPhotoBrowser/SD'
YYWebImage加载图片
pod 'GKPhotoBrowser/YY'
Kingfisher加载图片
pod 'GKPhotoBrowser/KF'
AVPlayer播放视频
pod 'GKPhotoBrowser/AVPlayer'
ZFPlayer播放视频
pod 'GKPhotoBrowser/ZFPlayer'
IJKPlayer播放视频
pod 'GKPhotoBrowser/IJKPlayer'
AFNetworking下载livePhoto
pod 'GKPhotoBrowser/AF'
Alamofire下载livePhoto
pod 'GKPhotoBrowser/Alamofire'
视频播放进度条
pod 'GKPhotoBrowser/Progress'
1、创建包含GKPhoto的数据源数组
NSMutableArray *photos = [NSMutableArray new];
[cell.timeLineFrame.model.images enumerateObjectsUsingBlock:^(GKTimeLineImage * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
GKPhoto *photo = [GKPhoto new];
photo.url = [NSURL URLWithString:obj.url];
photo.sourceImageView = cell.photosView.subviews[idx];
if (obj.isVideo) {
photo.videoUrl = [NSURL URLWithString:obj.video_url];
}
[photos addObject:photo];
}];
2、创建浏览器
GKPhotoBrowser *browser = [GKPhotoBrowser photoBrowserWithPhotos:photos currentIndex:index];
3、显示
[browser showFromVC:self];
更多功能及属性可在demo和代码中查看
对于iOS14的升级,如果出现图片显示不出来,黑屏等情况,需要把SDWebImage 升级到至少5.8.3版本
2.0.0之后修改了对gif图片的加载方式
1、使用SDWebImage(5.x)加载图片,请使用pod 'GKPhotoBrowser' 或 'GKPhotoBrowser/SD'
2、使用YYWebImage(1.0.5)加载图片,请使用pod 'GKPhotoBrowser/YY'
3、自定义图片加载类,如:SDWebImage 5.0以下版本,请使用pod 'GKPhotoBrowser/Core',然后添加图片加载类并实现GKWebImageProtocol协议
1、 如果使用SDWebImage,请使用SDAnimatedImage加载本地图片
photo.image = [SDAnimatedImage imageNamed:obj];
2、如果使用YYWebImage,请使用YYImage加载本地图片
photo.image = [YYImage imageNamed:obj];
需要设置属性isFollowSystemRotation为YES,此时isScreenRotateDisabled属性将失效
内部默认使用的AVPlayer播放视频,如果想要使用其他播放器可使用基础库,然后创建视频播放类并实现GKVideoPlayerProtocol协议,然后设置播放处理类
[browser setupVideoPlayerProtocol:[CustomPlayerManager class]];
查看其他代码中是否有分类修改了UIViewController的modalPresentationStyle,GKPhotoBrowser的默认modalPresentationStyle是UIModalPresentationCustom,如果有修改则需要屏蔽对GKPhotoBrowser的修改
1、demo
2、仿微信
3、今日头条
4、简书
pod trunk push --allow-warnings --skip-import-validation
最近更新
- 3.0.2 - 2024.07.26 1、livePhoto优化,增加是否清理缓存属性
- 3.0.1 - 2024.07.03 1、修复bug #193 2、livePhoto进度优化及增加标识
- 3.0.0 - 2024.07.01 1、支持livePhoto播放(本地、网络、相册)2、修复某些情况下浏览器不能释放的问题
- 2.8.2 - 2024.06.04 1、视频加载优化,增加播放失败处理 2、视频播放支持IJKPlayer
- 2.8.1 - 2024.05.24 头文件导入优化,pod优化
- 2.8.0 - 2024.05.21 1、网络加载支持Kingfisher 2、视频播放支持ZFPlayer 3、增加SwiftDemo
- 2.7.6 - 2024.03.20 privacy fix
- 2.7.4 - 2024.03.19 1、修复pageControl可点击的问题 2、添加隐私清单文件
- 2.7.3 - 2023.10.12 修复问题 #188 #189
- 2.7.2 - 2023.09.22 新增刷新单个photo数据的方法 #186
- 2.7.1 - 2023.09.12 修复问题 #184 #185
- 2.7.0 - 2023.09.04 修复视频播放设置isVideoReplay=NO后视频不能播放的问题
- 2.6.5 - 2023.08.30 1、新增加载失败错误处理 #180 2、修复放大后快速滑动重叠问题 #181
- 2.6.4 - 2023.08.24 1、修复横屏滑动后切换到竖屏显示异常问题 2、新增双击和放大缩小代理
- 2.6.3 - 2023.07.20 修复视频切换后不能自动播放问题
- 2.6.2 - 2023.07.07 1、适配 Mac 2、修复放大后有黑边的问题 #177
- 2.6.1 - 2023.07.05 自定义coverView时不隐藏pageControl
- 2.6.0 - 2023.06.05
- 1、优化自定义图片加载时的逻辑
- 2、新增内存清理相关属性,可在适当的时候清理内存
- 3、增加视频进度视图协议,可自定义视频进度view
- 4、新增大图加载demo,通过CATiledLayer显示
历史更新
-
2.5.9 - 2023.05.30 视频播放优化,新增微信聊天demo #173
-
2.5.8 - 2023.05.16 修复手势向上滑动时不缩放问题
-
2.5.7 - 2023.04.17
- 1、修复崩溃bug #170
- 2、新增属性可修改图片间距
- 3、修复放大状态下快速左右滑动显示异常问题
- 4、安全区域适配优化
-
2.5.6 - 2023.04.11
- 1、修复bug #168 #169
- 2、视频加载优化,增加获取视频尺寸方法
- 3、修复视频显示后立即滑动隐藏崩溃的问题
- 4、隐藏动画优化,修复放大状态下的隐藏闪动问题
-
2.5.4 - 2023.04.06
- 1、视频播放优化,修复bug #168
- 2、安全区域适配优化,修复横屏时切换问题
- 3、横屏显示及隐藏动画优化
-
2.5.3 - 2023.03.28 部分方法增加前缀,修复审核警告问题 #165 #166
-
2.5.2 - 2023.03.16 修复调用selectedPhoto和removePhoto方法后视频播放未停止的问题,视频播放优化
-
2.5.1 - 2023.03.15 修复使用videoView出现审核被拒的问题 #165,消除警告
-
2.5.0 - 2023.03.06
- 1、支持视频播放
- 2、代码拆分、优化
- 3、push显示支持滑动缩放返回
-
2.4.6 - 2023.02.20 修复问题 #154 #162
-
2.4.4 - 2022.10.18 新增isDoubleTapDisabled属性,禁止双击放大功能,可提高单击的响应时间
-
2.4.3 - 2022.10.08
- 1、修复图片宽高可能为0的问题 #151
- 2、优化加载原图时可能闪动的问题 #152
-
2.4.2 - 2022.09.20 适配iPhone 14 Pro屏幕,#150
-
2.4.1 - 2022.08.19
- 1、修复屏幕旋转bug #149
- 2、新增addNavigationController,可在显示图片浏览器后push到新的控制器
-
2.4.0 - 2022.07.27 修复横屏后屏幕朝上自动变为竖屏的问题 #147
-
2.3.8 - 2022.04.07 优化代码,修复bug #138
-
2.3.7 - 2022.03.25 新增animDuration属性,可自定义动画时间
-
2.3.6 - 2022.02.28 隐藏效果优化
-
2.3.5 - 2022.01.26 版本,安全区域适配优化,导航栏隐藏优化
-
2.3.4 - 2021.12.06 版本,状态栏适配优化
-
2.3.3 - 2021.10.12 当View controller-based status bar appearance设置为NO时适配状态栏 # 126
-
2.3.2 - 2021.08.05 优化pageControl的显示
-
2.3.1 - 2021.06.07 修复放大后滑动两张图片再返回显示异常的问题 #123
-
2.2.1 - 2021.05.08 手势添加位置修改
-
2.2.0 - 2021.04.20 修复从GKPhotoBrowser进入其他控制器再返回后的错乱问题 #120
-
2.1.9 - 2021.04.13 修复缩放状态下从后台进入前台缩放状态错误问题 #117
-
2.1.8 - 2021.03.25 修复加载多个本地图片导致的内存溢出问题 #93 #101
-
2.1.7 - 2021.03.11 修复内存泄漏bug
-
2.1.5 - 2021.03.02 修复手指缩放bug,修复自定义加载方式时代理不执行问题
-
2.1.4 - 2020.12.31 修复双击缩放问题#110,增加pageControl和保存按钮#107,解决与其他库冲突#108
-
2.1.3 - 2020.11.29 修复闪动问题#100,支持自定义图片加载类#94
-
2.1.2 - 2020.11.17 修复不传url只传sourceImageView时不能手势缩放的bug,去掉api弃用警告
-
2.1.1 - 2020.10.22 修改刘海屏手机判断方法,适配iPhone 12系列机型
-
2.1.0 - 2020.08.19 修复自定义coverView中UIButton点击响应延迟问题
-
2.0.8 - 2020.07.02 修复加载本地图片不能双击放大的bug
-
2.0.4 - 2020.06.18 修复删除图片bug,增加对PHAsset的支持
-
2.0.3 - 2020.06.15 适配支持屏幕旋转的APP及iPad
-
2.0.1 - 2020.06.10 优化图片单击的处理,支持自定义图片加载类
-
2.0.0 - 2020.04.28 优化GIF图片显示,支持SDWebImage 5.x 和 YYWebImage
-
1.6.0 - 2020.03.14 增加双击放大倍数
-
2020.03.12 修复crash #67,#71 感谢chimingzi,解决编译报错#65
-
2019.10.20 优化长图闪动问题,适配iOS13
-
2019.10.12 优化长图放大后点击隐藏时的闪动问题
-
2019.08.15
- 1、修复只有一张图片时的滑动问题
- 2、增加隐藏图片浏览器的方法
-
2019.07.24 增加方法可跳转到指定位置的图片
-
2019.07.02
- 1、修复禁止屏幕旋转后出现的不能滑动隐藏的bug
- 2、增加maxZoomScale属性,可自己设置最大缩放比例
-
2019.05.31 修复循环引用导致的内存溢出问题
-
2019.05.06 修复长图不能上滑问题
-
2019.05.05 细节优化,修复可能出现的黑圈闪动问题
-
2019.04.26 增加支持查看原图功能
-
2019.04.15 bug fixed
- 1、修复WillAppear可能出现的CALayer position contains NaN: [nan nan]问题
- 2、修复某些机型可能出现的zoom恢复原图后,不能滑动隐藏的问题
-
2019.03.28 增加GKPhotoBrowserFailStyle,可自定义图片加载失败后的显示方式
-
2019.03.21 适配SDWebImage 5.x版本
-
2019.03.18 修复图片加载器不显示问题
-
2019.01.09 增加浏览器完全消失后的回调
-
2018.12.29 优化图片隐藏时的图片旋转问题
-
2018.12.28 优化长图从底部滑动隐藏时出现的问题
-
2018.12.18 优化图片显示时的加载问题
-
2018.12.17 修复只传入sourceFrame时的显示问题
-
2018.12.10 增加是否开启处理手势冲突的属性isPopGestureEnabled
-
2018.11.09 优化只有一张图片显示时的细节
-
2018.09.18 适配iPhone XS,iPhone XS Max,iPhone XR
-
2018.08.30
- 1、修复删除图片时的图片重叠问题
- 2、增加自定义浏览器背景颜色属性
-
2018.08.24 修复加载失败时切换横竖屏加载视图位置不准及无法隐藏的问题
-
2018.08.20 修复影响UITableview与UICollectionView滑动卡顿问题
-
2018.08.07
- 1、移除FLAnimationImage
- 2、优化gif图片的加载,增加属性isLowGifMemory,可减少gif图片的加载内存。
-
2018.08.01
- 1、增加属性isAdaptiveSafeArea,控制是否自动适配安全区域
- 2、图片超过屏幕高度不能滑动消失问题修复(超长图滑动隐藏效果不是很好,目前没找到更好的解决方案)
-
2018.07.30
- 1、显示与隐藏动画优化
- 2、增加删除图片方法,重置图片数组方法
-
2018.06.30
- 1、去除多余注释
- 2、增加属性isFullWidthForLandScape 控制横屏显示
-
2018.06.13 支持GIF图片的显示
-
2018.05.28 修复本地图片不能双击放大的问题
-
2018.05.23 全面适配iPhone X
-
2018.05.14
- 1、修复创建子视图不更新布局bug
- 2、内存泄漏问题修复
-
2018.04.01
- 1、修复长按方式执行多次的bug
- 2、新增支持多种加载方式
-
QQ: 1094887059
-
QQ群:1047100313
-
支持作者