Skip to content

Banner广告(横幅广告)

WARNING

请在广告初始化成功后调用, 另外所有API请在UI线程中调用。

创建广告

使用Banner广告时,先创建Banner广告对象:VXBannerAd

java
VXBannerAd bannerAd = new VXBannerAd(activity, adId);

参数说明:

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

设置广告回调

Banner广告在加载、播放、 关闭、点击等时机,都会通过监听回调接口,通知给游戏层:

java

IBannerAdListener bannerAdListener = new IBannerAdListener() {
    @Override
    public void onFailed(int code, String msg) {
        // 广告播放失败
    }

    @Override
    public void onLoadFailed(int code, String msg) {
        // 广告加载失败
    }

    @Override
    public void onLoaded() {

        if (bannerContainer != null) {
            bannerContainer.removeAllViews();
            bannerContainer = null;
        }

        // 当广告加载成功后, 可以将广告view展示在当前界面UI的某个控件(bannerContainer)内
        bannerContainer = AdUtils.generateBannerViewContainer(AdDemoActivity.this, AdUtils.POS_BOTTOM);
        bannerAd.show(AdDemoActivity.this, bannerContainer);

    }

    @Override
    public void onShow() {
        // 广告曝光成功
    }

    @Override
    public void onClicked() {
        // 广告被点击
    }

    @Override
    public void onClosed() {
        // 广告被关闭
    }

    @Override
    public void onSkip() {

    }
};

bannerAd.setAdListener(bannerAdListener);

加载广告

设置好监听器类后, 在需要的时机可以加载Banner广告:

java
bannerAd.load(activity);

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

展示广告

广告加载成功后,可以调用show方法展示广告, 需要传入一个UI容器组件(bannerContainer)来渲染Banner广告:

java
bannerAd.show(activity, bannerContainer);

可以调用AdUtils.generateBannerViewContainer方法,在当前Activity的最上方或最下方,创建一个banner容器组件:

java
ViewGroup bannerContainer = AdUtils.generateBannerViewContainer(activity, AdUtils.POS_BOTTOM);

关闭广告

如果要关闭或隐藏Banner广告,可以直接如下操作:

java
if (bannerContainer != null) {
    bannerContainer.removeAllViews();
    bannerContainer = null;
}

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