iOS开屏广告解决方案XHLaunchAd3.0

一.前言:

1.以前因为项目须要,写了一个开屏广告组件XHLaunchAd,主要自用,后来发现愈来愈多的开发者,有这个需求.
2.随着使用人数的增长,部分开发者使用者提出了一些需求和问题,XHLaunchAd并不能很好的解决.
3.因而决定最近抽时间,把这个组件优化重构一下,解决网友以前提出一些问题和需求,并增长一些新功能,发布v3.0.0版本.
4.该项目目前已经收到 700 多个 star ,目前已经更新到v3.0.1版本
5.代码地址: github.com/CoderZhuXH/…git

-> XHLaunchAd (3.0.1)
   开屏广告解决方案,支持图片/视频、静态/动态、全屏/半屏广告,支持iPhone/iPad,自带图片下载、缓存功能,无其余三方依赖
   pod 'XHLaunchAd', '~> 3.0.1'
   - Homepage: https://github.com/CoderZhuXH/XHLaunchAd
   - Source:   https://github.com/CoderZhuXH/XHLaunchAd.git
   - Versions: 3.0.1, 3.0.0, 2.2.2, 2.2.1, 2.2.0, 2.1.9, 2.1.8, 2.1.7, 2.1.6,
   2.1.5, 2.1.4, 2.1.3, 2.1.2, 2.1.1, 2.1.0, 2.0.1, 2.0, 1.2, 1.1.4, 1.1.3,
   1.1.2, 1.1, 1.0 [master repo]
复制代码

二.主要更新:

1.增长mp4视频开屏广告 2.增长对本地资源支持 3.增长预缓存接口 4.增长更多属性及接口,具备更强的自定义性 5.可设置显示完成动画类型 6.可自定义跳过按钮 7.拥有更优雅的接入接口 8.优化缓存机制,bug fix等等github

三.接入后效果:

四.使用方法:

在AppDelegate didFinishLaunchingWithOptions方法中添加下面代码(提早设置App启动页为LaunchImage)缓存

-1.添加图片开屏广告⬇️

--1.1使用默认配置快速初始化

//1.使用默认配置初始化
    XHLaunchImageAdConfiguration *imageAdconfiguration = [XHLaunchImageAdConfiguration defaultConfiguration];
    //广告图片URLString/或本地图片名(.jpg/.gif请带上后缀)
    imageAdconfiguratuin.imageNameOrURLString = @"image0.jpg";
    //广告点击打开连接
    imageAdconfiguration.openURLString = @"http://www.returnoc.com";
    //显示图片开屏广告
    [XHLaunchAd imageAdWithImageAdConfiguration:imageAdconfiguration delegate:self];
复制代码

--1.2自定义配置初始化

//2.自定义配置初始化
    XHLaunchImageAdConfiguration *imageAdconfiguration = [XHLaunchImageAdConfiguration new];
    //广告停留时间
    imageAdconfiguration.duration = 5;
    //广告frame
    imageAdconfiguration.frame = CGRectMake(0, 0, [UIScreen mainScreen].bounds.size.width, [UIScreen mainScreen].bounds.size.height-150);
    //广告图片URLString/或本地图片名(.jpg/.gif请带上后缀)
    imageAdconfiguration.imageNameOrURLString = @"image0.jpg";
    //网络图片缓存机制(只对网络图片有效)
    imageAdconfiguration.imageOption = XHLaunchAdImageRefreshCached;
    //图片填充模式
    imageAdconfiguration.contentMode = UIViewContentModeScaleToFill;
    //广告点击打开连接
    imageAdconfiguration.openURLString = @"http://www.returnoc.com";
    //广告显示完成动画
    imageAdconfiguration.showFinishAnimate =ShowFinishAnimateFadein;
    //跳过按钮类型
    imageAdconfiguration.skipButtonType = SkipTypeTimeText;
    //后台返回时,是否显示广告
    imageAdconfiguration.showEnterForeground = NO;
    //显示图片开屏广告
    [XHLaunchAd imageAdWithImageAdConfiguration:imageAdconfiguration delegate:self]; 
    
复制代码

-2.添加视频开屏广告⬇️

--2.1 使用默认配置快速初始化

//1.使用默认配置初始化
    XHLaunchVideoAdConfiguration *videoAdconfiguration = [XHLaunchVideoAdConfiguration defaultConfiguration];
    //广告视频URLString/或本地视频名(请带上后缀)
    videoAdconfiguration.videoNameOrURLString = @"video0.mp4";
    //广告点击打开连接
    videoAdconfiguration.openURLString = @"http://www.returnoc.com";
    //显示视频开屏广告
    [XHLaunchAd videoAdWithVideoAdConfiguration:videoAdconfiguration delegate:self];
复制代码

--2.2 自定义配置初始化

//2.自定义配置
    XHLaunchVideoAdConfiguration *videoAdconfiguration = [XHLaunchVideoAdConfiguration new];
    //广告停留时间
    videoAdconfiguration.duration = 5;
    //广告frame
    videoAdconfiguration.frame = CGRectMake(0, 0, [UIScreen mainScreen].bounds.size.width, [UIScreen mainScreen].bounds.size.height);
    //广告视频URLString/或本地视频名(请带上后缀)
    videoAdconfiguration.videoNameOrURLString = @"video1.mp4";
    //视频填充模式
    videoAdconfiguration.scalingMode = MPMovieScalingModeAspectFill;
    //广告点击打开连接
    videoAdconfiguration.openURLString =  @"http://www.returnoc.com";
    //广告显示完成动画
    videoAdconfiguration.showFinishAnimate =ShowFinishAnimateFadein;
     //跳过按钮类型
    videoAdconfiguration.skipButtonType = SkipTypeTimeText;
    //后台返回时,是否显示广告
    videoAdconfiguration.showEnterForeground = NO;
    //显示视频开屏广告
    [XHLaunchAd videoAdWithVideoAdConfiguration:videoAdconfiguration delegate:self];
复制代码

注意:

若你的广告图片/视频URL来源于数据请求,请在请求数据前设置等待时间,在数据请求成功回调里,配置广告,以下:

//1.由于数据请求是异步的,请在数据请求前,调用下面方法配置数据等待时间.
//2.设为3即表示,启动页将停留3s等待服务器返回广告数据,3s内等到广告数据,将正常显示广告,不然将自动进入window的RootVC

  //设置数据等待时间
    [XHLaunchAd setWaitDataDuration:3];
    //广告数据请求
    [Network getLaunchAdImageDataSuccess:^(NSDictionary * response) {
        
      //在此处利用服务器返回的广告数据,按上面示例添加开屏广告代码
      XHLaunchImageAdConfiguration *imageAdconfiguration = [XHLaunchImageAdConfiguration ... 
     //配置相关参数.... 
     //显示开屏广告
     [XHLaunchAd imageAdWithImageAdConfiguration:imageAdconfiguration delegate:self];
              
    } failure:^(NSError *error) {
    }];   
    
复制代码

-3.点击事件

/** * 广告点击事件 回调 */
- (void)xhLaunchAd:(XHLaunchAd *)launchAd clickAndOpenURLString:(NSString *)openURLString;
{
    if(openURLString)
    {
    	 //跳转到广告详情页面
        WebViewController *VC = [[WebViewController alloc] init];
        VC.URLString = openURLString;
        [self.window.rootViewController presentViewController:VC animated:YES completion:nil];
        
    }
}

复制代码

-4.自定义跳过按钮

//1.XHLaunchImageAdConfiguration 和XHLaunchVideoAdConfiguration 均有一个configuration.customSkipView 属性
//2.自定义一个skipView 赋值给configuration.customSkipView属性 即可替换默认跳过按钮 以下:
configuration.customSkipView = [self customSkipView];

-(UIView *)customSkipView
{
    UIButton *button = [UIButton buttonWithType:UIButtonTypeCustom];
    button.backgroundColor =[ UIColor clearColor];
    button.layer.cornerRadius = 3.0;
    button.layer.borderWidth = 1.0;
    button.layer.borderColor = [UIColor whiteColor].CGColor;
    [button setTitleColor:[UIColor whiteColor] forState:UIControlStateNormal];
    button.titleLabel.font = [UIFont systemFontOfSize:13];
    button.frame = CGRectMake(15,[UIScreen mainScreen].bounds.size.height-55, 85, 40);
    [button addTarget:self action:@selector(skipAction) forControlEvents:UIControlEventTouchUpInside];
    return button;
}

-(void)skipAction
{
    [XHLaunchAd skipAction];
}

/** * 代理方法-倒计时回调 * * @param launchAd XHLaunchAd * @param duration 倒计时时间 */
-(void)xhLaunchAd:(XHLaunchAd *)launchAd customSkipView:(UIView *)customSkipView duration:(NSInteger)duration
{
    UIButton *button = (UIButton *)customSkipView;//此处转换为你以前的类型
    //设置自定义跳过按钮倒计时
    [button setTitle:[NSString stringWithFormat:@"自定义%lds",duration] forState:UIControlStateNormal];
}
复制代码

-5.预缓存接口(若是你须要提早下载并缓存广告图片或视频请调用下面方法)

/** * 批量下载并缓存image(异步) * * @param urlArray image URL Array */
+(void)downLoadImageAndCacheWithURLArray:(NSArray <NSURL *> * )urlArray;

/** * 批量下载并缓存视频(异步) * * @param urlArray 视频URL Array */
+(void)downLoadVideoAndCacheWithURLArray:(NSArray <NSURL *> * )urlArray;
复制代码

-6.其余代理方法

/** * 图片下载完成/或本地图片读取完成 回调 * * @param launchAd XHLaunchAd * @param image image */
-(void)xhLaunchAd:(XHLaunchAd *)launchAd imageDownLoadFinish:(UIImage *)image
{
    NSLog(@"图片下载完成/或本地图片读取完成回调");
}
/** * 视频下载完成回调 * * @param launchAd XHLaunchAd * @param pathURL 视频保存在本地的path */
-(void)xhLaunchAd:(XHLaunchAd *)launchAd videoDownLoadFinish:(NSURL *)pathURL
{
    NSLog(@"video下载/加载完成/保存path = %@",pathURL.absoluteString);
}

/** * 视频下载进度回调 */
-(void)xhLaunchAd:(XHLaunchAd *)launchAd videoDownLoadProgress:(float)progress total:(unsigned long long)total current:(unsigned long long)current
{
    NSLog(@"总大小=%lld,已下载大小=%lld,下载进度=%f",total,current,progress);
    
}
/** * 广告显示完成 */
-(void)xhLaunchShowFinish:(XHLaunchAd *)launchAd
{
    NSLog(@"广告显示完成");
}

/** 若是你想用SDWebImage等框架加载网络广告图片,请实现此代理 @param launchAd XHLaunchAd @param launchAdImageView launchAdImageView @param url 图片url */
-(void)xhLaunchAd:(XHLaunchAd *)launchAd launchAdImageView:(UIImageView *)launchAdImageView URL:(NSURL *)url
{
    [launchAdImageView sd_setImageWithURL:url];

}

复制代码

-7.其余操做

/** * 清除XHLaunch本地缓存 */
+(void)clearDiskCache;

/** * 获取XHLaunch本地缓存大小(M) */
+(float)diskCacheSize;

/** * 缓存路径 */
+(NSString *)xhLaunchAdCachePath;

复制代码

五.小结:

XHLaunchAd 3.0 拥有更灵活的调用方式和更优雅的接口,后期我还会持续维护并更新他,但愿能给更多开发者带来便利!服务器