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