iOS - 一行代码实现多功能广告轮播View

目录

1. 特色一览
2. 使用示例_01
3. 使用示例_02
4. 如何自定义
5. 核心代码
6. 结语

特色一览

• 使用UICollectionView的复用机制
  • 使用复用机制可有效提高性能，无论播放多少张图片，实际创建的控件永远只有两个UICollectionViewCell，有效减少内存损耗
• 支持广告轮播图的自定义
  • 本作品提供若干接口可以实现简单的自定义
• 网络图片异步下载和缓存机制
  • 网络图片采用子线程异步下载，不会造成卡顿，第一次下载时会自动保存到沙盒，下次启动直接从沙盒获取图片
• 加载网络图片时可设置占位图片
  • 支持设置占位图片，在网络情况比较差的情况下可以先显示其他相应图片
• 一行代码实现点击图片的响应事件
  • 使用Block回调实现图片的点击响应事件， 并返回被点击图片的相关信息
• 波浪刷新效果
  • 使用波浪效果进行刷新操作，生动有趣

使用示例_01

(效果图01)

使用方法

1. 下载并复制KHAdView文件夹下的源代码到你的工程目录；
2. 初始化KHAdView；
3. 一句代码实现加载网络图片, 设置占位图片和响应点击事件；
   说明 : 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];
    }];

4. 或者一句代码实现加载本地图片和设置响应点击事件；

[self.khAdView setUpLocalImagesWithSource:self.localArr 
        ClickHandler:^(NSInteger index, NSString *imgSrc, UIImage *img) {
             //在这个block中设置点击图片后要进行的操作
             [weakSelf pushToImgViewControllerWithIndex:index Image:img ImageSource:imgSrc];
   }];

5. 开启或关闭图片轮播的定时器。

    [self.khAdView startTimer];
    [self.khAdView stopTimer];
   

使用示例_02

(效果图02)

使用方法

1. 隐藏底部的PageControl， 再使用一行代码初始化波浪View；

      self.khAdView.hideBottomView = YES;
    self.khAdView.hidePageControl = YES;
      [self.khAdView enableWavingWithDuration:0.f
                                     WaveSpeed:12.f
                                     WaveHeight:12.f
                                     WaveColor:[UIColor whiteColor]];

2. 在scrollViewDidEndDecelerating代理方法中启动波动效果。

  - (void)scrollViewDidEndDecelerating:(UIScrollView *)scrollView{
     [self.khAdView startWaving];
  }  
    

如何自定义：

1. 改变控件的颜色
   • 改变底部背景栏的颜色，默认是黑色

    self.khAdView.bottomViewColor = [UIColor redColor];

- 改变**PageControl**的指示颜色，默认是白色

       self.khAdView.pageIndicatorTintColor = [UIColor yellowColor];

• 改变当前页PageControl的指示颜色，默认是红色

      self.khAdView.currentPageIndicatorTintColor = [UIColor blackColor];

2. 改变底部背景栏的高度，默认是30

    self.khAdView.bottomViewHeight = 50;

3. 改变底部背景栏的透明度，默认是0.3

    self.khAdView.alpha = 0.5;

4. 改变定时器的时间间隔，默认是2

    self.khAdView.timeInterval = 1.f;

5. 改变广告视图的滚动方向，默认是从右向左滚动

    self.khAdView.direction = KHScrollDirectionFromLeft;

核心代码

本作品的核心代码有三大部分：

1. 通过UICollectionView实现循环轮播效果；
2. 网络图片的异步下载和缓存机制；
3. 波浪效果的实现。
   由于篇幅有限，在此只详述第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地址， 本作品后续会持续更新，并添加更多有趣的效果，喜欢的朋友可以留下你的评论或提出你的改进建议。