falconAd

Method

openBanner closeBanner hideBanner showBanner openInterstitial openSplash

概述

本插件封装了猎鹰广告SDK。

注意-iOS

使用本插件之前需要在Info.plist文件中配置白名单

<key>LSApplicationQueriesSchemes</key>
    <array>
<!-- 微信 URL Scheme ⽩白名单--> <string>wechat</string>
 <string>weixin</string> <!-- 新浪微博 URL Scheme ⽩白名单--> <string>sinaweibohd</string>
 <string>sinaweibo</string> 
<string>sinaweibosso</string> 
<string>weibosdk</string> 
<string>weibosdk2.5</string> <!-- QQ、Qzone URL Scheme ⽩白名单--> <string>mqqapi</string> 
<string>mqq</string> 
<string>mqqOpensdkSSoLogin</string>
<string>mqqconnect</string>
<string>mqqopensdkdataline</string> 
<string>mqqopensdkgrouptribeshare</string>
<string>mqqopensdkfriend</string> 
<string>mqqopensdkapi</string>
<string>mqqopensdkapiV2</string>
<string>mqqopensdkapiV3</string>
<string>mqzoneopensdk</string> 
<string>wtloginmqq</string> 
<string>wtloginmqq2</string> 
<string>mqqwpa</string> 
<string>mqzone</string> 
<string>mqzonev2</string> 
<string>mqzoneshare</string> 
<string>wtloginqzone</string> 
<string>mqzonewx</string> 
<string>mqzoneopensdkapiV2</string> 
<string>mqzoneopensdkapi19</string> 
<string>mqzoneopensdkapi</string> 
<string>mqzoneopensdk</string> 
<!-- ⽀支付宝 淘宝 URL Scheme ⽩白名单--> <string>alipay</string> 
<string>alipayshare</string> 
<string>taobao</string> 
<string>itaobao</string> 
<!-- 天猫 URL Scheme ⽩白名单--> <string>tmall</string> 
<string>itmall</string> 
<!-- 京东 Scheme ⽩白名单--> <string>openApp.jdMobile</string>
<!-- ⼤大众点评 Scheme ⽩白名单--> <string>dianping</string> 
<!-- 聚美优品 Scheme ⽩白名单--> <string>JuMei</string> 
<string>jumeimall</string> 
<!-- 美团 Scheme ⽩白名单--> <string>meituan0000</string> 
<string>iMeituan</string> 
<!-- 苏宁 Scheme ⽩白名单--> <string>suning</string> 
<!-- 唯品会 Scheme ⽩白名单--> <string>vipshop</string>
      </array>

Info.plist配置（必须）

     <key>AppLovinSdkKey</key>
<string>2QfqtBkZoUqpJao0MSbf6va1OodbcDhsGLkrat-Gamen4MCNRLXPTr9mTFGEQm5V17gtK6H4W-H2WXZtiVO</string>

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-3940256094244~14802511</string>

Info.plist 文件配置方法，参考 APICloud 官方论坛帖子

注意

appID、广告ID请联系猎鹰广告后台账号申请联系人进行申请：

管理后台登录地址：猎鹰广告

使用此插件之前必须先配置 config 文件，配置方法如下：

     <feature name="falconAd">
       <param name="appId_iOS" value="" />
       <param name="appId_Android" value="" />
    </feature>

字段描述:

appId_iOS、appId_Android：appId

插件接口

openBanner

打开Banner广告页面

openBanner({params},callback(ret, err))

params

appId:

类型：字符串类型 (仅ios支持)
描述：appId

spaceId:

类型：字符串类型
描述：Android广告位id

spaceId_iOS:

类型：字符串类型
描述：iOS广告位id

rect：

类型：JSON 对象
描述：（可选项）插件的位置及尺寸
内部字段：

{
    x: 0,   //（可选项）数字类型；插件左上角的 x 坐标（相对于所属的 Window 或 Frame）；默认：0
    y: 0,   //（可选项）数字类型；插件左上角的 y 坐标（相对于所属的 Window 或 Frame）；默认：0
    w: 320, //（可选项）数字类型；插件的宽度；默认：所属的 Window 或 Frame 的宽度
    h: 220  //（可选项）数字类型；插件的高度；默认：220
}

fixedOn：

类型：字符串类型
描述：（可选项）插件视图添加到指定 frame 的名字（只指 frame，传 window 无效）
默认：插件依附于当前 window

fixed：

类型：布尔
描述：（可选项）插件是否随所属 window 或 frame 滚动
默认值：true（不随之滚动）

callback(ret, err)

ret:

类型：JSON 对象
描述：注册结果
内部字段：

{
    state:''            //字符串类型；回调的事件类型，取值范围如下：            
                        //exposure：Banner广告展示
                        //error：请求广告条数据失败，失败信息查看err
                        //close：banner条被用户关闭
                        //clicked：banner条被点击
}

err:

类型：JSON 对象
描述：注册结果
内部字段：

{
    code: 1,           //数字类型；错误码
    msg: ''            //字符串类型；错误信息
}

示例代码

var falconAd = api.require('falconAd');
falconAd.openBanner({
  appId:'',
  spaceId:'',
}, function(ret, err) {
    if (ret) {
        api.alert({
            msg: JSON.stringify(ret)
        })
    } else {
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

closeBanner

关闭Banner广告页面

closeBanner()

示例代码

var falconAd = api.require('falconAd');
falconAd.closeBanner()
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

hideBanner

隐藏Banner广告页面

hideBanner()

示例代码

var falconAd = api.require('falconAd');
falconAd.hideBanner()
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

showBanner

显示Banner广告页面

showBanner()

示例代码

var falconAd = api.require('falconAd');
falconAd.showBanner()
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

openInterstitial

打开插屏广告页面

openInterstitial({params},callback(ret, err))

params

appId:

类型：字符串类型 (仅ios支持)
描述：appId

spaceId:

类型：字符串类型
描述：Android广告位id

spaceId_iOS:

类型：字符串类型
描述：iOS广告位id

callback(ret, err)

ret:

类型：JSON 对象
描述：注册结果
内部字段：

{
    state:''            //字符串类型；回调的事件类型，取值范围如下：            
                        //exposure：插屏广告视图展示成功
                        //error：请求广告条数据失败，失败信息查看err
                        //close：被用户关闭
                        //clicked：被点击
}

err:

类型：JSON 对象
描述：注册结果
内部字段：

{
    code: 1,           //数字类型；错误码
    msg: ''            //字符串类型；错误信息
}

示例代码

var falconAd = api.require('falconAd');
falconAd.openInterstitial({
  appId:'',
  spaceId:'',
}, function(ret, err) {
    if (ret) {
        api.alert({
            msg: JSON.stringify(ret)
        })
    } else {
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

openSplash

打开开屏广告页面

openSplash({params},callback(ret, err))

params

appId:

类型：字符串类型 (仅ios支持)
描述：appId

spaceId:

类型：字符串类型
描述：Android广告位id

spaceId_iOS:

类型：字符串类型
描述：iOS广告位id

callback(ret, err)

ret:

类型：JSON 对象
描述：注册结果
内部字段：

{
    state:''            //字符串类型；回调的事件类型，取值范围如下：                
                        //success：开屏广告加载成功
                        //exposure：开屏广告曝光回调
                        //error：请求广告条数据失败，失败信息查看err
                        //close：被用户关闭
                        //clicked：被点击
}

err:

类型：JSON 对象
描述：注册结果
内部字段：

{
    code: 1,           //数字类型；错误码
    msg: ''            //字符串类型；错误信息
}

示例代码

var falconAd = api.require('falconAd');
falconAd.openSplash({
  appId:'',
  spaceId:''
}, function(ret, err) {
    if (ret) {
        api.alert({
            msg: JSON.stringify(ret)
        })
    } else {
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});