adView

来自于：开发者立即使用

概述

adView 封装了adView聚合广告平台的SDK，支持横幅、插屏、开屏主流广告形式。使用该模块需要先到adView官网申请得到应用的SDK-KEY值。模块采用拆分的机制，防止安装包过大，您需要将所需的第三方SDK以模块样式添加，在 这篇帖子 中下载添加使用

使用此模块之前需要先配置 config.xml 文件，配置完毕，需通过云端编译生效，配置方法如下：

• 名称：adView

• 参数：android_key ，（必须配置）adView官网后台申请到的安卓应用SDK-KEY值。

示例代码

  <feature name="adView">
    <param name="android_key" value="SDK20171229121124u7qv5iq78htehpl"/>
  </feature>

initsdk

初始化SDK

initsdk

示例代码

var adView = api.require('adView');
adView.initsdk();

可用性

可用性Android系统

可提供的1.0.0及更高版本

showBanner

显示横幅广告

showBanner({params}, callback(ret))

params

x：

• 类型：字符串
• 描述：横幅左上角的 x 坐标（相对于所属的 Window 或 Frame）。
• 默认值：0

y:

• 类型：字符串
• 描述：（可选项）数字类型；横幅左上角的 y 坐标（相对于所属的 Window 或 Frame）；
• 默认值：0

w:

• 类型：字符串
• 描述：（可选项）数字类型；横幅的宽度；页面从x位置开始自动充满所属的 Window 或 Frame 的宽度；默认：
• 默认值：自适应。宽度值不能小于300，否则曝光不成功，导致无法计费。//部分平台应用横幅广告宽度仅为320*50，无法填满屏幕，会居中显示;

h：

• 描述：（不可选项）数字类型；横幅的高度
• 固定值：50 。

fixedOn：

• 类型：字符串类型
• 描述：（可选项）模块添加到指定window或frame

• 默认：模块依附于当前 window

• fixed:

• 类型：布尔

• 描述：（可选项）模块是否随所属 window 或 frame 滚动
• 默认值：true（不随之滚动）

callback(ret)

ret：

• 类型：JSON对象
• 内部字段：

{
    status: show/click/failed/hide
}

示例代码

var adView = api.require('adView');
adView.showBanner({
  x : 0,
  y : 0,
  fixedOn:'',
  fixed : true      
}, 
  function(ret, err) {
    alert("ret: " + JSON.stringify(ret) + "\err: " + JSON.stringify(err));
});

可用性

Android系统

可提供的1.0.0及更高版本

Destory

销毁广告

Destory(callback(ret))

callback(ret)

ret：

• 类型：JSON对象
• 内部字段：

{
    status: destory
}

示例代码

var adView = api.require('adView');
adView.Destory(function(ret, err) {
  alert("ret: " + JSON.stringify(ret) + "\err: " + JSON.stringify(err));
});

补充说明

广告销毁后横幅/插屏/开屏均不可用，需再次initsdk后才能调用

可用性

Android系统

可提供的1.0.0及更高版本

showInterstitialAD

插屏广告

showInterstitialAD(callback(ret))

callback(ret, err)

ret：

• 类型：JSON对象
• 内部字段：

{
    status: falied/show/click/close  
}

示例代码

var adViewinst = api.require('adViewinst');
adViewinst.showInterstitialAD(function(ret, err) {
  alert("ret: " + JSON.stringify(ret) + "\err: " + JSON.stringify(err));
});

可用性

Android系统

可提供的1.0.0及更高版本

showSplash

开屏广告

showSplash(callback(ret))

callback(ret, err)

ret：

• 类型：JSON对象
• 备注：回调close/click/failed中任意一个参数，都意味开屏广告结束
• 内部字段：

{
    status: show/close/click /failed 
}


示例代码

```js
var adView = api.require('adView');;
adView.showSplash(function(ret, err) {
   alert("ret: " + JSON.stringify(ret) + "\err: " + JSON.stringify(err));
});

可用性

Android系统

可提供的1.0.0及更高版本

补充说明

部分广告平台请求到的广告尺寸无法全屏显示，所以将开屏广告的背景设为透明