Skip to content

激励视频广告

WARNING

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

创建广告

使用激励视频广告时,先创建激励视频广告对象:VXRewardAd

java
VXRewardAd rewardAd = new VXRewardAd(activity, adId, itemName, itemNum);

参数说明:

参数名称参数类型参数说明
activityActivity当前游戏调用广告的宿主Activity
adIdString聚合SDK后台创建的聚合广告位ID,如果还没创建,可以参考文档:获取广告参数
itemNameString玩家观看激励视频广告后,获得的奖励名称
itemNumint玩家观看激励视频广告后,获得的奖励数量

设置广告回调

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

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函数判断当前广告是否就绪, 如果就绪再播放。

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