Skip to content

插屏广告

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];

参数说明:

参数名称参数类型参数说明
adIdString聚合SDK后台创建的聚合广告位ID,如果还没创建,可以参考文档:获取广告参数
controllerUIViewController当前游戏调用广告的宿主Controller

广告加载成功, 会触发上面监听器中的vxAdInterstitialDidLoaded事件; 加载失败, 会触发上面监听器中的vxAdInterstitialDidLoadFailed事件。

播放广告

广告加载成功后, 就可以在玩家点击广告播放按钮时,进行播放了:

objc
if ([interstitialAd isAdReady]) {
    [interstitialAd showAdWithController:self];
}

建议调用播放之前, 先通过isAdReady函数判断当前广告是否就绪, 如果就绪再播放。

版权所有© 2021-2030 上海丞诺网络科技有限公司