Appearance
开屏广告
WARNING
请在广告初始化成功后调用, 另外所有API请在UI线程中调用。
自动开屏广告
因为开屏广告一般是作为启动屏展示, 结合U8聚合SDK提供的分包工具, 我们支持自动将开屏广告作为启动屏(启动Activity),无需游戏开发者接入, 只需要在后台广告参数中打开开关,配置好广告位ID即可:
按上图配置后,通过U8聚合SDK打包工具分包后, 就可以测试开屏广告效果了。
但是,请注意, 自动开屏广告也有一定的局限性:。
创建广告
使用插屏广告时,先创建插屏广告对象:VXSplashAd
:
java
VXSplashAd splashAd = new VXSplashAd(activity, adId);
参数说明:
参数名称 | 参数类型 | 参数说明 |
---|---|---|
activity | Activity | 当前游戏调用广告的宿主Activity |
adId | String | 聚合SDK后台创建的聚合广告位ID,如果还没创建,可以参考文档:获取广告参数 |
设置广告回调
开屏广告在加载、播放、 关闭、点击等时机,都会通过监听回调接口,通知给游戏层:
java
ISplashAdListener splashAdListener = new ISplashAdListener() {
@Override
public void onFailed(int code, String msg) {
// 广告播放失败
}
@Override
public void onLoadFailed(int code, String msg) {
// 广告加载失败
}
@Override
public void onLoaded() {
// 广告加载成功, 可以展示
if (splashAd.isReady()) {
splashAd.show(AdDemoActivity.this);
}
}
@Override
public void onShow() {
// 广告曝光成功
}
@Override
public void onClicked() {
// 广告被点击
}
@Override
public void onClosed() {
// 广告被关闭
}
@Override
public void onSkip() {
// 广告被跳过
}
};
splashAdListener.setAdListener(splashAdListener);
加载广告
设置好监听器类后, 在需要的时机可以加载开屏广告:
java
splashAd.load(activity);
广告加载成功, 会触发上面监听器中的onLoaded
事件; 加载失败, 会触发上面监听器中的onLoadFailed
事件。
播放广告
广告加载成功后, 就可以在玩家点击广告播放按钮时,进行播放了:
java
if (splashAd.isReady()) {
splashAd.show(activity);
}
建议调用播放之前, 先通过isReady
函数判断当前广告是否就绪, 如果就绪再播放。