目录
- 特色一览
- 使用示例_01
- 使用示例_02
- 如何自定义
- 核心代码
- 结语
特色一览
- 使用UICollectionView的复用机制
- 使用复用机制可有效提高性能，无论播放多少张图片，实际创建的控件永远只有两个UICollectionViewCell，有效减少内存损耗
- 支持广告轮播图的自定义
- 本作品提供若干接口可以实现简单的自定义
- 网络图片异步下载和缓存机制
- 网络图片采用子线程异步下载，不会造成卡顿，第一次下载时会自动保存到沙盒，下次启动直接从沙盒获取图片
- 加载网络图片时可设置占位图片
- 支持设置占位图片，在网络情况比较差的情况下可以先显示其他相应图片
- 一行代码实现点击图片的响应事件
- 使用Block回调实现图片的点击响应事件， 并返回被点击图片的相关信息
- 波浪刷新效果
- 使用波浪效果进行刷新操作，生动有趣
使用示例_01
(效果图01)
使用方法
- 下载并复制KHAdView文件夹下的源代码到你的工程目录；
- 初始化KHAdView；
- 一句代码实现加载网络图片, 设置占位图片和响应点击事件；
说明 : ClickHandler这个block中返回的参数分别为图片的索引, 图片的来源(URL或图片名), 以及图片本身。
[self.khAdView setUpOnlineImagesWithSource:self.urlArr
PlaceHolder:[UIImage imageNamed:@"001"]
ClickHandler:^(NSInteger index, NSString *imgSrc, UIImage *img) {
//在这个block中设置点击图片后要进行的操作
[weakSelf pushToImgViewControllerWithIndex:index Image:img ImageSource:imgSrc];
}];
- 或者一句代码实现加载本地图片和设置响应点击事件；
[self.khAdView setUpLocalImagesWithSource:self.localArr
ClickHandler:^(NSInteger index, NSString *imgSrc, UIImage *img) {
//在这个block中设置点击图片后要进行的操作
[weakSelf pushToImgViewControllerWithIndex:index Image:img ImageSource:imgSrc];
}];
-
开启或关闭图片轮播的定时器。
[self.khAdView startTimer]; [self.khAdView stopTimer];
使用示例_02
(效果图02)
使用方法
- 隐藏底部的PageControl， 再使用一行代码初始化波浪View；
self.khAdView.hideBottomView = YES;
self.khAdView.hidePageControl = YES;
[self.khAdView enableWavingWithDuration:0.f
WaveSpeed:12.f
WaveHeight:12.f
WaveColor:[UIColor whiteColor]];
- 在scrollViewDidEndDecelerating代理方法中启动波动效果。
- (void)scrollViewDidEndDecelerating:(UIScrollView *)scrollView{
[self.khAdView startWaving];
}
如何自定义：
- 改变控件的颜色
- 改变底部背景栏的颜色，默认是黑色
self.khAdView.bottomViewColor = [UIColor redColor];
- 改变**PageControl**的指示颜色，默认是白色
self.khAdView.pageIndicatorTintColor = [UIColor yellowColor];
- 改变当前页PageControl的指示颜色，默认是红色
self.khAdView.currentPageIndicatorTintColor = [UIColor blackColor];
- 改变底部背景栏的高度，默认是30
self.khAdView.bottomViewHeight = 50;
- 改变底部背景栏的透明度，默认是0.3
self.khAdView.alpha = 0.5;
- 改变定时器的时间间隔，默认是2
self.khAdView.timeInterval = 1.f;
- 改变广告视图的滚动方向，默认是从右向左滚动
self.khAdView.direction = KHScrollDirectionFromLeft;
核心代码
本作品的核心代码有三大部分：
- 通过UICollectionView实现循环轮播效果；
- 网络图片的异步下载和缓存机制；
- 波浪效果的实现。
由于篇幅有限，在此只详述第2部分的核心代码。有兴趣详细了解所有代码的朋友可以到本人的GitHub地址下载。
- (void)downloadImages:(NSArray *)urlArr{
//遍历所有的图片url
for (NSInteger i = 0; i < urlArr.count; i++) {
NSString *imageUrl = urlArr[i];
//尝试获取内存缓存中的图片
UIImage *image = [self.imageDictM objectForKey:imageUrl];
//如果没有内存缓存，到沙盒中寻找缓存
if (!image) {
NSString *cachePath = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject];
NSString *filePath = [cachePath stringByAppendingString:[imageUrl lastPathComponent]];
BOOL exist = [[NSFileManager defaultManager] fileExistsAtPath:filePath];
//如果没有沙盒缓存，查看当前子线程是否正在下载该图片
if (!exist) {
[self.imageDictM setObject:self.placeHolderImg forKey:imageUrl];
NSOperation *downloadOP = [self.operationDictM objectForKey:imageUrl];
//如果没有子线程缓存，开创子线程下载图片
if (!downloadOP) {
NSBlockOperation *download = [NSBlockOperation blockOperationWithBlock:^{
NSData *imageData = [NSData dataWithContentsOfURL:[NSURL URLWithString:imageUrl]];
UIImage *image = [UIImage imageWithData:imageData];
NSLog(@"下载图片----%ld", i);
//容错处理
if (!image) {
[self.operationDictM removeObjectForKey:imageUrl];
return;
}
//保存下载好的图片到内存缓存和沙盒缓存中
[self.imageDictM setObject:image forKey:imageUrl];
[imageData writeToFile:filePath atomically:YES];
[self.operationDictM removeObjectForKey:imageUrl];
[[NSOperationQueue mainQueue] addOperationWithBlock:^{
//如果子线程缓存数==0, 则所有图片已经下载完毕, 刷新视图
NSInteger operationCount = self.operationDictM.count;
if (operationCount == 0) {
self.images = [self getDisplayImgs:self.imageDictM DataSource:urlArr];
[self.collectionView reloadData];
}
}];
}];
//保存子线程缓存
[self.operationDictM setObject:download forKey:imageUrl];
[self.queue addOperation:download];
}
}else{
//沙盒中有缓存时直接从沙盒中加载图片
image = [UIImage imageWithData:[NSData dataWithContentsOfFile:filePath]];
[self.imageDictM setObject:image forKey:imageUrl];
NSLog(@"从沙盒中获取图片");
}
}else{
//内存中有缓存时直接从内存中加载图片
[self.imageDictM setObject:image forKey:imageUrl];
NSLog(@"从内存中获取图片");
}
}
}
结语
具体的代码和Demo可参考GitHub地址， 本作品后续会持续更新，并添加更多有趣的效果，喜欢的朋友可以留下你的评论或提出你的改进建议。
