2.广告能力

2.1 设置广告打开回调

Android

ADNative.setAdResultCallback(AdParamCallback callback);

示例:

//设置广告回调
ADNative.setAdResultCallback(new ADManager.AdParamCallback() {

    @Override
    public void onStatusChanged(ADParam arg0, int status) {
        // TODO Auto-generated method stub
        Log.d(TAG,"onStatusChanged:"+status);
    }

    @Override
    public void onRequestAddGameCoin(ADParam arg0, int arg1, int arg2,
            String arg3) {
        // TODO Auto-generated method stub
        Log.d(TAG,"onRequestAddGameCoin");

    }

    @Override
    public void onOpenResult(ADParam adParam, int result) {
        // TODO Auto-generated method stub
        Log.d(TAG,"onOpenResult:"+result);
        //判断广告类型是否是视频
        if(adParam.getType().equals(ADDef.AD_TypeName_Video)){

        }

        if(result== ADParam.ADOpenResult_Success){//广告打开成功

        }
        else {//广告打开失败

        }
    }
});

回调方法说明: AdParamCallback .onOpenResult(onOpenResult(ADParam adParam , int result)) :广告打开结果通知

  • adParam:广告相关参数(可获取广告ID,广告状态,广告代理商)

  • result:广告打开结果:0成功 1失败 2取消

AdParamCallback.onRequestAddGameCoin(ADParam adParam, int result, int num, String reason):积分墙类广告的钻石奖励通知

  • adParam:广告相关参数

  • result:奖励结果类型:0成功 1失败 2取消

  • num:奖励数量

  • reason:通知字符串

2.2 打开广告

2.2.1 打开普通广告(插屏/视频/横幅/开屏)

Android

ADNative.openAd(String adPositionName);

iOS

[IOSLoader openAd:@"adPositioname"];
 [IOSLoader openAd:@"adPositioname" adCallback:^(BOOL flag, KTMADType type) {
        if (type == KTMADTypePlaque) {
            //插屏
        }
        if (type == KTMADTypeVideo) {
            //视频
        }
    }];

回调方法说明:

adCallback:^(BOOL flag, KTMADType type):广告打开结果回调。

  • flag:true-打开成功 false-打开失败(插屏不需要处理flag)视 频下发奖励依据flag(flag为true下发奖励,flag为false不下发奖励)

  • type : KTMADTypePlaque(插屏),KTMADTypeVideo(视频)

因插屏和视频需要广告展示时关闭背景音,广告关闭时恢复背景音。故可根据type进行判断。

参数:

  • adPositionName: 广告位名称

Unity

Wb.ADManager.Instance.OpenAd(string adPositionName, Action<bool> callBackFun);

示例:

Wb.ADManager.Instance.OpenAd("home_mfzs", result =>
{
        if (result)
        {
            ShowToast("视频广告打开成功", false);
        }
        else
        {
            ShowToast("视频广告打开失败", true);
        }
});

参数:

  • adPositionName: 广告位名称

  • callBackFun:广告打开回调

Creator

Wb.Ad.openAd(adPositionName: string, callBackFun: Function);

示例:

Wb.Ad.openAd("home_mfzs", function (result: boolean) {
            if (result)
        {
            ShowToast("视频广告打开成功", false);
        }
        else
        {
            ShowToast("视频广告打开失败", true);
        }
 });

参数:

  • adPositionName: 广告位名称

  • callBackFun:广告打开回调

2.2.2 打开原生广告

Android

ADNative.openYsAd(String adPositionName,int width, int height, int x, int y);

参数:

  • adPositionName: 广告位名称

  • width:宽度,单位-像素

  • height:高度,单位-像素

  • x:左上角横坐标,单位-像素

  • y:左上角纵坐标,单位-像素

iOS

[IOSLoader openYsAd:string width:int height:int x:int y:int];

参数:

  • adPositionName: 广告位名称

  • width:宽度,单位-像素

  • height:高度,单位-像素

  • x:左上角横坐标,单位-像素

  • y:左上角纵坐标,单位-像素

Unity

Wb.ADManager.Instance.OpenYsAd(String adPositionName,int width, int height, int x, int y);

参数:

  • adPositionName: 广告位名称

  • width:宽度,单位-像素

  • height:高度,单位-像素

  • x:左上角横坐标,单位-像素

  • y:左上角纵坐标,单位-像素

Wb.ADManager.Instance.OpenYsAd(RectTransform rect, string adPositionName);

参数:

  • adPositionName: 广告位名称

  • rect:Unity的坐标区域

Wb.ADManager.Instance.OpenYsAd(string adPositionName, float width, float height, float x, float y, float winSizeW, float winSizeH);

参数:

  • adPositionName: 广告位名称

  • width:设计分辨率宽度

  • height:设计分辨率高度

  • x:设计分辨率左上角横坐标

  • y:设计分辨率左上角纵坐标

  • winSizeW:设计分辨率屏幕宽度

  • winSizeH:设计分辨率屏幕高度

Creator

Wb.Ad.openYsAd(adPositionName: string, width: number, height: number, x: number, y: number, callback: Function);

参数:

  • adPositionName: 广告位名称

  • width:宽度,单位-像素

  • height:高度,单位-像素

  • x:左上角横坐标,单位-像素

  • y:左上角纵坐标,单位-像素

  • callBackFun:广告打开回调

2.3 查看广告是否就绪

Android

ADNative.isAdReady(String adPositionName);
ADNative.isAdReady2(String adPositionName, String type);

iOS

[IOSLoader isAdReady:@"adPositioname"];
[IOSLoader isAdReady:@"adPositioname" type:@"type"];

Unity

Wb.ADManager.Instance.IsAdReady(string adPositioname)

参数:

  • adPositionName:广告位名称

  • type: 广告类型 (plaque-插屏 video-视频 banner-横幅 wall-积分墙 splash-开屏 msg-信息流广告)

Creator

Wb.Ad.isAdReady(adPositionName: string);

参数:

  • adPositionName:广告位名称

2.4 关闭广告

Android

ADNative.closeAd(String adPositioname);

iOS

[IOSLoader closeAd:@"adPositioname"];

Unity

Wb.ADManager.Instance.CloseAd(string adPositioname);

参数:

  • adPositionName: 广告位名称

Creator

Wb.Ad.closeAd(adPositionName: string);

参数:

  • adPositionName: 广告位名称

2.5 获取视频限制次数

Android

ADNative.getVideoLimitOpenNum();

iOS

[IOSLoader getVideoLimitOpenNum];

Unity

Wb.ADManager.Instance.GetVideoLimitOpenNum();

返回值:

返回可播放次数,-1表示无限次。

Creator

Wb.Ad.getVideoLimitOpenNum();

返回值:

返回可播放次数,-1表示无限次。

2.6 广告位是否已打开(不推荐)

Android

ADNative.isAdOpen(String adPositionName);

iOS

[IOSLoader isAdOpen:@"adPositionName"];

返回值:

  • true-广告已被打开

  • false-广告未被打开

2.7 某关卡是否出现广告

Android

ADNative.isAdBeOpenInLevel(String adPositionname,int lv);

iOS

[IOSLoader isAdBeOpenInLevel:@"adPositionName" level:lv];

Unity

Wb.ADManager.Instance.IsAdBeOpenInLevel(string adPositionname,int lv);

参数:

  • adPositionname:广告位名称

  • lv:关卡编号(1-无限)

返回值:

  • true-可出现

  • false-不可出现

Creator

Wb.Ad.isAdBeOpenInLevel(adPositionname: string, lv: number);

参数:

  • adPositionname:广告位名称

  • lv:关卡编号(1-无限)

返回值:

  • true-可出现

  • false-不可出现

2.8 查询某种广告类型是否存在

Android

ADNative.isAdTypeExist(String adType);

iOS

[IOSLoader isAdTypeExist:@"adType"];

Unity

Wb.ADManager.Instance.IsAdTypeExist(string adType)

参数:

  • adType:广告类型 (plaque-插屏 video-视频 banner-横幅 wall-积分墙 splash-开屏 msg-信息流广告)

返回值:

  • true-存在

  • false-不存在

Creator

Wb.Ad.isAdTypeExist(adType: string);

参数:

  • adType:广告类型 (plaque-插屏 video-视频 banner-横幅 wall-积分墙 splash-开屏 msg-信息流广告)

返回值:

  • true-存在

  • false-不存在

2.9 获取广告位控制参数

Android

ADNative.getAdPositionParam(String positionName,String key);

iOS

[IOSLoader getAdPositionParam:@"positionName" valueName:@"key"]

Unity

Wb.ADManager.Instance.GetAdPositionParam(string positionName,string key);

参数:

  • positionName-广告位名称

  • key-控制字段名称

返回值:

key对应的value值

Creator

Wb.Ad.getAdPositionParam(positionName: string, key: string);

参数:

  • positionName-广告位名称

  • key-控制字段名称

返回值:

key对应的value值

最后更新于