Appearance
插屏广告
WARNING
请在广告初始化成功后调用, 另外所有API请在UI线程中调用。
创建广告
使用插屏广告时,先创建插屏广告对象:VX_InterstitialAd
:
objc
VX_InterstitialAd *interstitialAd = [[VX_InterstitialAd alloc] init];
设置广告回调
插屏广告在加载、播放、 关闭、点击等时机,都会通过监听VX_InterstitialAdDelegate
,通知给游戏层:
objc
@interface AdViewController()<VX_InterstitialAdDelegate>
//...
@end
@implementation AdViewController
- (void)vxAdInterstitialDidClicked {
// 广告被点击
}
- (void)vxAdInterstitialDidClosed {
// 广告被关闭
}
- (void)vxAdInterstitialDidFailed:(VXAdErrorCode)code withMessage:(nonnull NSString *)message {
// 广告播放失败
}
- (void)vxAdInterstitialDidLoadFailed:(VXAdErrorCode)code withMessage:(nonnull NSString *)message {
// 广告加载失败
}
- (void)vxAdInterstitialDidLoaded {
// 广告加载成功
[self.interstitialAd showAdWithController:self];
}
- (void)vxAdInterstitialDidShow {
// 广告曝光成功
}
- (void)vxAdInterstitialDidSkipped {
// 广告被跳过
}
@end
// 设置回调
[interstitialAd setDelegate:self];
加载广告
设置好监听器类后, 在需要的时机可以加载插屏广告:
objc
[interstitialAd loadAdWithUnitId:adId controller:self];
参数说明:
参数名称 | 参数类型 | 参数说明 |
---|---|---|
adId | String | 聚合SDK后台创建的聚合广告位ID,如果还没创建,可以参考文档:获取广告参数 |
controller | UIViewController | 当前游戏调用广告的宿主Controller |
广告加载成功, 会触发上面监听器中的vxAdInterstitialDidLoaded
事件; 加载失败, 会触发上面监听器中的vxAdInterstitialDidLoadFailed
事件。
播放广告
广告加载成功后, 就可以在玩家点击广告播放按钮时,进行播放了:
objc
if ([interstitialAd isAdReady]) {
[interstitialAd showAdWithController:self];
}
建议调用播放之前, 先通过isAdReady
函数判断当前广告是否就绪, 如果就绪再播放。