写在前面
什么是VungleSDK ？VungleSDK一个广告平台的SDK。
0、相关链接
1、工作原理
init SDK -->loading -->play --> remove cache --> loading
简而言之，就是初始化-->加载缓存广告视频-->播放-->清除对应播放的缓存视频-->加载缓存新的广告视频
如果网速足够快的话，在看完一个广告之前，就已经成功缓存好新的广告，下次播放即可实现0秒等待
2、开始接入
步骤1：添加 Vungle 框架到您的 Xcode 项目
添加 VungleSDK.framework 到您的项目
分为Cocoapods接入和手动接入，参考文档即可正常接入。
这里要说一下关于手动添加，链接一些其他的本地框架，其实*.framework的，新版本的Xcode，都可以不用手动添加了，可以参考我的另一篇文章
添加“ObjC”链接器标记，如图：
步骤2：删除 iOS 状态栏
作用应该在于广告的全屏正常显示，在项目的info文件中添加，右键点击该文件-->Open as --> Source code
<key>UIStatusBarTintParameters</key>
<dict>
<key>UINavigationBar</key>
<dict>
<key>Style</key>
<string>UIBarStyleDefault</string>
<key>Translucent</key>
<false/>
</dict>
</dict>
步骤3：添加代码
注意：调用初始化的方法，就开始缓存广告了，有可能初始化还没成功，就成功缓存，这种情况下，需要先对这个属性initialized进行判断，否则直接调用play会不成功
初始化SDK
- (BOOL)startWithAppId:(nonnull NSString *)appID placements:(nonnull NSArray *)placements error:(NSError **)error;
一旦初始化成功，以下回调会被调用：
- (void)vungleSDKDidInitialize;
一旦初始化失败，以下回调会被调用：
-(void)vungleSDKFailedToInitializeWithError:(NSError *)error;
注意：
- appID需要在管理后台中创建应用获取，placements这是默认广告位，可以有多个，具体需要在管理后台进行配置，拿到placementID放入该数组。
- 调用这个函数，如果appID 和 placements两个参数都为nil，会返回FALSE。如果其中一个参数是nil，或者错误，则回调vungleSDKFailedToInitializeWithError。
- 一个placementID代表一个广告位，一个广告位的广告，每次打开都是不同的，因为打开后会清除缓存，重新缓存新的广告。
为广告位置加载广告
- (BOOL)loadPlacementWithID:(NSString *)placementID error:(NSError **)error;
注意：
- loadPlacementWithID返回YES，不代表缓存成功，只能代表加载成功，缓存还是需要一定的时间的。
一旦缓存成功，会回调这个方法：
- (void)vungleAdPlayabilityUpdate:(BOOL)isAdPlayable placementID:(nullable NSString *)placementID;
注意
- 初始化SDK的时候，默认是有一个广告位（placementID）为自动缓存，具体可以在管理后台进行设置你想要的广告位为默认缓存，也就是说，调用SDK初始化的方法，还没回调成功，有可能该广告位已经缓存广告成功了。实测是这样的。
可以通过调用以下方法，来判断该广告位的广告是否具备可播放的性质,一旦返回YES，即说明该广告可播放，进而调用play的函数：
- (BOOL)isAdCachedForPlacementID:(nonnull NSString *)placementID;
播放广告
一旦确定广告位置的广告已准备好，可使用以下方法来播放广告：
- (BOOL)playAd:(UIViewController *)controller options:(nullable NSDictionary *)options placementID:(nullable NSString *)placementID error:( NSError *__autoreleasing _Nullable *_Nullable)error;
开始播放 和 结束播放，都有对应的回调，如下：
- (void)vungleWillShowAdForPlacementID:(nullable NSString *)placementID;
- (void)vungleWillCloseAdWithViewInfo:(VungleViewInfo *)info placementID:(NSString *)placementID;
Flex Feed 广告
非全屏广告，具体请参考文档。
我的接入
我的接入思路，以及遇到的问题
1、因为我做的是SDK，现在在我的SDK项目中，接入VungleSDK，等于说，我暴露出去的，分为两个函数，接入我的SDK，需要开APP启动的时候先调用第一个函数，然后具体在播放的时机，再调用第二个函数。如下：
//初始化并开始缓存
-(void)startCacheAdvertisingSuccess:(EventBlock)initSuccessBlock
failure:(EventBlock)initFailureBlock;
//开始播放
-(void)showAdvertisingWithCloseTipsTitle:(NSString*)closeTipsTitle
closeTipsContent:(NSString*)closeTipsContent
startPlay:(EventBlock)startPlayBlock
endPlay:(EventBlock)endPlayBlock
playFailure:(FailureBlock)playFailureBlock;
2、由于SDK缓存全看网速，在必要的时候，需要我手动遍历，未cache的则调用loading，并做一些等待提示，缓存成功，需要直接播放。如果是自动缓存，则只有开发者调用时才播放。
-(void)loadAllPlacement{
WEAKSELF;
[self.placementIDsArray enumerateObjectsUsingBlock:^(NSString *placementID, NSUInteger idx, BOOL * _Nonnull stop) {
//已经缓存的，不再缓存
if (![self.sdk isAdCachedForPlacementID:placementID]) {
NSError *error = nil;
[weakSelf.sdk loadPlacementWithID:placementID error:&error];
}
}];
}
//获取已缓存的广告位
-(NSArray*)alreadyCachedPlacement:(NSArray*)allArr{
__block NSMutableArray *arr = [NSMutableArray array];
[allArr enumerateObjectsUsingBlock:^(NSString *placementID, NSUInteger idx, BOOL * _Nonnull stop) {
if ([self.sdk isAdCachedForPlacementID:placementID]) {
[arr addObject:placementID];
}
}];
return arr;
}
遇到的问题
在管理后台新增一个应用后，添加一个广告位，只有一个广告的时候，该广告位为自动缓存的广告位。
写好自己的demo之后，使用了VungleSDK官方的文档中提供的appID 和 placements，发现我的demo能够正常播放广告，可是使用了自己管理后台的，就不能正常播放广告，要么没播放完就停止播放并且黑屏，要么点击广告关闭按钮后黑屏。由此我猜想是：该广告位对应的测试状态下的广告有问题，不能正常缓存。
解决问题
于是，找了他们官方的文档半天（大概是这个位置），才找到一个支持邮箱（monetize@vungle.com），于是有了以下对话：
我发邮件寻求帮助：
技术支持的回复：（注意：这里说是一般需要30分钟才生效！）
我的建议：
技术支持的回复：
小结
有趣，VungleSDK很少人用？反正基本找不到相关的接入教程，相关官方文档也没有人评论，而官方文档又没有提示这个测试广告有问题的幺蛾子！还好官方的工作人员邮件倒是回复的很快，因此结合文档，坚定自己的判断，就解决问题了。
