Appearance
激励视频广告
WARNING
请在广告初始化成功后调用, 另外所有API请在UI线程中调用。
创建广告
使用激励视频广告时,先创建激励视频广告对象:VXRewardAd
:
java
VXRewardAd rewardAd = new VXRewardAd(activity, adId, itemName, itemNum);
参数说明:
参数名称 | 参数类型 | 参数说明 |
---|---|---|
activity | Activity | 当前游戏调用广告的宿主Activity |
adId | String | 聚合SDK后台创建的聚合广告位ID,如果还没创建,可以参考文档:获取广告参数 |
itemName | String | 玩家观看激励视频广告后,获得的奖励名称 |
itemNum | int | 玩家观看激励视频广告后,获得的奖励数量 |
设置广告回调
激励视频广告在加载、播放、 关闭、点击等时机,都会通过监听回调接口,通知给游戏层:
java
IRewardAdListener rewardAdListener = new IRewardAdListener() {
@Override
public void onRewarded(String itemName, int itemNum) {
// 激励视频广告观看完成,符合发放奖励的条件, 在这里给玩家发放奖励
}
@Override
public void onFailed(int code, String msg) {
// 激励视频播放失败
}
@Override
public void onLoadFailed(int code, String msg) {
// 激励视频加载失败
}
@Override
public void onLoaded() {
//激励视频广告加载成功,可以展示
if (rewardAd.isReady()) {
rewardAd.show(AdDemoActivity.this);
}
}
@Override
public void onShow() {
// 激励视频广告曝光成功事件
}
@Override
public void onClicked() {
// 广告被点击事件
}
@Override
public void onClosed() {
// 广告关闭事件
}
@Override
public void onSkip() {
// 广告被跳过事件
}
};
rewardAd.setAdListener(rewardAdListener);
加载广告
设置好监听器类后, 在需要的时机可以加载激励视频广告(为了避免播放时卡顿,建议可以提前加载激励视频广告):
java
rewardAd.load(activity);
广告加载成功, 会触发上面监听器中的onLoaded
事件; 加载失败, 会触发上面监听器中的onLoadFailed
事件。
播放广告
广告加载成功后, 就可以在玩家点击广告播放按钮时,进行播放了:
java
if (rewardAd.isReady()) {
rewardAd.show(activity);
}
建议调用播放之前, 先通过isReady
函数判断当前广告是否就绪, 如果就绪再播放。