Appearance
Banner广告(横幅广告)
WARNING
请在广告初始化成功后调用, 另外所有API请在UI线程中调用。
创建广告
使用Banner广告时,先创建Banner广告对象:VXBannerAd
:
java
VXBannerAd bannerAd = new VXBannerAd(activity, adId);
1
参数说明:
参数名称 | 参数类型 | 参数说明 |
---|---|---|
activity | Activity | 当前游戏调用广告的宿主Activity |
adId | String | 聚合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);
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
加载广告
设置好监听器类后, 在需要的时机可以加载Banner广告:
java
bannerAd.load(activity);
1
广告加载成功, 会触发上面监听器中的onLoaded
事件; 加载失败, 会触发上面监听器中的onLoadFailed
事件。
展示广告
广告加载成功后,可以调用show方法展示广告, 需要传入一个UI容器组件(bannerContainer)来渲染Banner广告:
java
bannerAd.show(activity, bannerContainer);
1
可以调用AdUtils.generateBannerViewContainer
方法,在当前Activity的最上方或最下方,创建一个banner容器组件:
java
ViewGroup bannerContainer = AdUtils.generateBannerViewContainer(activity, AdUtils.POS_BOTTOM);
1
关闭广告
如果要关闭或隐藏Banner广告,可以直接如下操作:
java
if (bannerContainer != null) {
bannerContainer.removeAllViews();
bannerContainer = null;
}
1
2
3
4
2
3
4