iOS视频广告(二) GoogleAds-IMA-iOS-SDK

iOS视频广告(二) GoogleAds-IMA-iOS-SDK

(GoogleAds-IMA-iOS-SDK 二次封装)

---

开发

1. 开发环境: Xcode 7
2. 运行条件: iOS(9.0+)
3. 管理平台: admanger帐号。 https://admanager.google.com
4. 官网文档地址:
   https://developers.google.com/interactive-media-ads/docs/sdks/ios/

 

注意:

• 管理平台,官网文档都需要vpn才能浏览.
• GoogleAds-IMA-iOS-SDK只提供了视频广告功能, 如果要实现横幅广告/插页式广告/原生广告/激励广告可以使用Google-Mobile-Ads-SDK, 后边的文章会介绍
• 开源框架：github地址
• 谷歌视频广告SDK介绍： iOS视频广告(一) GoogleAds-IMA-iOS-SDK

 

（如果使用有什么问题，可以给我留言，欢迎一起学习，欢迎github-star, 点赞）

---

为什么要封装SDK:

• 虽说可以直接使用谷歌的SDK写进项目中, 但是实现起来还是小复杂, 需要踩的坑还是有点多. (比如调用顺序变换可能会导致广告播不出来)
• 提供给开发者加载广告接口不止一个，没接触过谷歌SDK, 挨个看,测试浪费精力。
• 使用起来代码看起来会有些乱, 耦合性高, 不方便后期的维护, 而且需要处理的代理回调方法稍微有些小麻烦。

 

不多说废话, 直接给大家讲讲 JXVideoAds 如何使用, 帮助大家快速用起来。

---

JXVideoAds介绍

 

JXVideoAds是一个对谷歌视频广告SDK进行二次封装的框架, JXVideoAds主要提供了两个类控制广告的生命周期，任选一个使用即可:

（1）、 JXAVideoOperator - 基于NSObjct， 用于加载广告，类似于manager。

• 必须传入一个(UIView)container - 作为广告播放的容器视图。
• 必须传入(StateBlock)state - 广告加载和调用状态的回调。
• 必须传入(NSString)tagUrl - 广告Url。
• 可选：(ProgressBlock)progress - 加载进度回调。
• 可选：(AVPlayer)player - 播放器， JXVideoOperator可以根据传入的player返回给你广告播放进度。
• 可选：userContext：- 广告加载器标识。
• 可选：(ParamsBlock)params - 自定义参数构建Block。

 

（2）、JXAVideoView - 基于UIView，作为广告播放的容器视图，也是广告的管理者。（推荐使用这个类，使用起来更简易，内部自己封装好了AVPlayer，无需传入）

• 必须传入(StateBlock)state - 广告加载和调用状态的回调。
• 必须传入(NSString)tagUrl - 广告Url。
• 可选：(ProgressBlock)progress - 加载进度回调。
• 可选：userContext：- 广告加载器标识。
• 可选：(ParamsBlock)params - 自定义参数构建Block。

 

（另外JXAVideoParamsBuilder - 一个参数构建者，内部封装了一些常用的个性化参数，点语法依次自定义参数，开发者可以挑选使用。）

---

Installation [安装]

安装，只需将以下面代码添加到您的Podfile:

platform :ios, '9.0'

target 'TargetName' do
pod 'JXVideoAds'
end

注意 !!!  :
* OC - 终端安装命令正常输入: pod install
* Swift - 终端安装命令: IS_FRAMEWORK=1 pod install

因为Swift必须使用framework(use_frameworks!), 所以安装不了objc源码,只能打包安装.

---

Frame set [框架集合]

• API 外部应该访问的接口
• Common SDK内部公共类
• GoogleIma 谷歌广告API

---

The UI effect:

 

• Breakpoint Play

  
  
  breakpoint_play.gif

 

• Fullscreen

  
  
  fullscreen.gif

---

SDK例子：

 

[JXAVideoView 使用] :

 

Example 1

 

// import
#import "JXAVideoView.h"

// 加载广告

- (IBAction)params:(id)sender {
    [self.containerView params:^JXAVideoParamsBuilder *(JXAVideoParamsBuilder *paramsBuilder) {
        return  paramsBuilder
        .autoPlayAdBreaks(YES)
        .adTagUrl(tag);
    } state:^(JXAVideoAdsState state, JXAVideoAds *video) {
        switch (state) {
                
            case JXAVideoAdsState_Loaded:
                NSLog(@"已经加载完毕 - JXAVideoAdsState_Loaded");
//                [video play];
                break;
                
            case JXAVideoAdsState_Started:
                NSLog(@"已经开始播放广告 - JXAVideoAdsState_Started");
                break;
            case JXAVideoAdsState_Error:
                NSLog(@"加载错误 - JXAVideoAdsState_Error");
                break;
            case JXAVideoAdsState_Pause:
                NSLog(@"广告暂停 - JXAVideoAdsState_Pause");
                break;
            case JXAVideoAdsState_Ended:
                NSLog(@"广告播放结束 - JXAVideoAdsState_Ended");
                break;
            case JXAVideoAdsState_Skipped:
                NSLog(@"广告已经跳过 - JXAVideoAdsState_Skipped");
                break;
                
            default:
                break;
        }
    }];
}

// 不使用时，最好销毁。
- (void)viewDidDisappear:(BOOL)animated {
    [super viewDidDisappear:animated];
    [self.containerView remove];
}

---

Example 2

 

// import
#import "JXAVideoView.h"

- (IBAction)paramsP:(id)sender {
    
    [self.containerView params:^JXAVideoParamsBuilder *(JXAVideoParamsBuilder *paramsBuilder) {
        return  paramsBuilder
        .autoPlayAdBreaks(YES)
        .language(@"en")
        .enableBackgroundPlayback(YES)
        .volume(@1)
        .adTagUrl(tagOne)
        .userContext(nil)
        .player(nil)
        .mimeTypes(@[ @"video/mp4", @"application/x-mpegURL"])
        .bitrate(1024)
        .webOpenerPresentingController([JXViewController new])
        .webOpenerDelegate(self);
    } state:^(JXAVideoAdsState state, JXAVideoAds *video) {
        switch (state) {
                
            case JXAVideoAdsState_Loaded:
                NSLog(@"已经加载完毕 - JXAVideoAdsState_Loaded");
                                [video play];
                break;
                
            case JXAVideoAdsState_Started:
                NSLog(@"已经开始播放广告 - JXAVideoAdsState_Started");
                break;
            case JXAVideoAdsState_Error:
                NSLog(@"加载错误 - JXAVideoAdsState_Error");
                break;
            case JXAVideoAdsState_Pause:
                NSLog(@"广告暂停 - JXAVideoAdsState_Pause");
                break;
            case JXAVideoAdsState_Ended:
                NSLog(@"广告播放结束 - JXAVideoAdsState_Ended");
                break;
            case JXAVideoAdsState_Skipped:
                NSLog(@"广告已经跳过 - JXAVideoAdsState_Skipped");
                break;
                
            default:
                break;
        }
    } progress:^(CGFloat current, CGFloat duration) {
        NSLog(@"currentTime -- %f \n duration -- %f", current, duration);
    }];
}

// 不使用时，最好销毁。
- (void)viewDidDisappear:(BOOL)animated {
    [super viewDidDisappear:animated];
    [self.containerView remove];
}

---

Example 3 and so on ...

 

---

[XAVideoOperator 使用] :

 

Example 1

#import "JXAVideoOperator.h"

- (IBAction)mNormal:(id)sender {
    
    self.operator = [[JXAVideoOperator alloc]
                    initWithTagUrl:tagOne
                    containerView:self.containerView
                    userContext:nil
                    state:^(JXAVideoAdsState state,
                            JXAVideoAds *video) {
                        switch (state) {
                                
                            case JXAVideoAdsState_Loaded:
                                NSLog(@"广告加载完毕 - JXAVideoAdsState_Loaded");
                                [video play];
                                break;
                                
                            case JXAVideoAdsState_Started:
                                NSLog(@"已经开始播放广告 - JXAVideoAdsState_Started");
                                break;
                            case JXAVideoAdsState_Error:
                                NSLog(@"加载错误 - JXAVideoAdsState_Error");
                                break;
                            case JXAVideoAdsState_Pause:
                                NSLog(@"广告暂停 - JXAVideoAdsState_Pause");
                                break;
                            case JXAVideoAdsState_Ended:
                                NSLog(@"广告播放结束 - JXAVideoAdsState_Ended");
                                break;
                            case JXAVideoAdsState_Skipped:
                                NSLog(@"广告已经跳过 - JXAVideoAdsState_Skipped");
                                break;
                                
                            default:
                                break;
                        }
                    }];
}
...

- (void)viewDidDisappear:(BOOL)animated {
    [super viewDidDisappear:animated];
    [self.operator remove];
}

Example 2 and so on ...

#import "JXAVideoOperator.h"
...

Demo地址