iOS视频广告(二) GoogleAds-IMA-iOS-SDK
(GoogleAds-IMA-iOS-SDK 二次封装)
开发
- 开发环境: Xcode 7
- 运行条件: iOS(9.0+)
- 管理平台: admanger帐号。 https://admanager.google.com
- 官网文档地址:
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"
...
