QuintGao/GKPhotoBrowser

Watch 25

Star 1.3k

Fork 216

iOS仿微信、今日头条等图片浏览器

GKPhotoBrowser是一个可高度自定义的图片、视频浏览器，支持多种显示、隐藏方式，支持自定义遮罩等

参考： KSPhotoBrowser， MJPhotoBrowser(已弃用)

重要

如果在使用过程中遇到问题，请先检查使用的版本是否是最新版本（可在说明最上面的pod后面查看），如果不是最新版本，请先更新到最后版本，看看问题是否存在，如果依然存在，可提issue说明或加我QQ1094887059直接问我，最好能提供demo。

3.1.0升级说明

** 3.1.0版本之后对项目部分代码进行了拆分，增加了GKPhotoBrowserConfigure配置类，升级后可按以下方式进行配置

方法一

browser.configure.showStyle = GKPhotoBrowserShowStyleZoom;
[browser.configure setupWebImageProtocol:GKYYWebImageManager.new];

方法二

GKPhotoBrowserConfigure *configure = GKPhotoBrowserConfigure.defaultConfig;
configure.showStyle = GKPhotoBrowserShowStyleZoom;
[configure setupWebImageProtocol:GKYYWebImageManager.new];

browser.configure = configure;

特性

支持图片浏览、视频播放、图片视频混排等
支持本地、网络、相册等资源
支持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'

默认Cover视图

pod 'GKPhotoBrowser/Cover'

使用

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和代码中查看

常见问题

1、iOS14 升级

对于iOS14的升级，如果出现图片显示不出来，黑屏等情况，需要把SDWebImage 升级到至少5.8.3版本

2、gif图片的加载

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协议

3、本库支持多种自定义（图片加载、视频播放、livePhoto下载、遮罩视图等等）

如果想自定义图片加载，请创建类并实现GKWebImageProtocol协议，并在浏览器显示之前进行配置

GKPhotoBrowserConfigure *configure = GKPhotoBrowserConfigure.defaultConfig;
[configure setupWebImageProtocol:CustomWebManager.new];

browser.configure = configure;

如果想自定义视频播放，请创建类并实现GKVideoPlayerProtocol协议，并在浏览器显示之前进行配置

GKPhotoBrowserConfigure *configure = GKPhotoBrowserConfigure.defaultConfig;
[configure setupVideoPlayerProtocol:CustomPlayerManager.new];

browser.configure = configure;

4、对于支持屏幕旋转的APP及iPad的适配

需要设置属性isFollowSystemRotation为YES，此时isScreenRotateDisabled属性将失效

5、滑动返回时显示黑屏（不出现背景渐变）

查看其他代码中是否有分类修改了UIViewController的modalPresentationStyle，GKPhotoBrowser的默认modalPresentationStyle是UIModalPresentationCustom，如果有修改则需要屏蔽对GKPhotoBrowser的修改

效果图

1、demo

2、仿微信

3、今日头条

4、简书

发布

pod trunk push --allow-warnings --skip-import-validation

版本记录

作者

QQ： 1094887059
QQ群：1047100313
简书
支持作者

&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp

回到顶部

关于

iOS仿微信、今日头条等图片浏览器

最后更新于 1 days ago

License

MIT

资源链接

https://github.com/QuintGao/GKPhotoBrowser