接入指南 API 工具 其他

banner 广告

为了方便开发者接入,联盟共建了统一 SDK,开发者接入 sdk 后能更快的实现登录、支付与广告功能,建议采用统一 SDK 方式接入。

qg.createBannerAd(Object object)

创建 banner 广告组件,每次调用该方法创建 banner 广告都会返回一个全新的实例。

参数

Object object

属性类型默认值必填说明
adUnitIdString广告单元 id
adIntervalsNumber广告自动刷新的间隔时间,单位为秒,参数值必须大于等于 30(该参数不传入时 Banner 广告不会自动刷新)
styleObjectbanner 广告组件的样式
style(banner 广告组件的样式)
结构属性类型默认值必填说明
leftNumberbanner 广告组件的左上角横坐标,单位 px。
topNumberbanner 广告组件的左上角纵坐标,单位 px。
widthNumberbanner 广告组件的宽度,单位 px。
heightNumberbanner 广告组件的高度,单位 px。

返回值

BannerAd

banner 广告组件实例。banner 广告组件是一个原生组件,层级比普通组件高。banner 广告组件默认是隐藏的,需要调用 BannerAd.show() 将其显示。banner 广告会根据开发者设置的宽度进行等比缩放,缩放后的尺寸将通过 BannerAd.onResize() 事件中提供。

属性

Object style

banner 广告组件的样式。style 上的属性的值仅为开发者设置的值,banner 广告会根据开发者设置的宽度进行等比缩放,缩放后的真实尺寸需要通过 BannerAd.onResize() 事件获得。

属性类型说明
leftNumberbanner 广告组件的左上角横坐标,单位 px。
topNumberbanner 广告组件的左上角纵坐标,单位 px。
widthNumberbanner 广告组件的宽度,单位 px。最小 300,最大至 屏幕宽度(屏幕宽度可以通过 qg.getSystemInfoSync() 获取)。
heightNumberbanner 广告组件的高度,单位 px。

方法

BannerAd.onResize(Function listener)

监听 banner 广告尺寸变化事件。

参数 listener(Object res)

banner 广告尺寸变化事件的监听函数

属性类型说明
widthNumber缩放后的宽度,单位 px。
heightNumber缩放后的高度,单位 px。

BannerAd.destroy()

销毁 banner 广告。

BannerAd.onClose(Function listener)

监听 banner 广告关闭事件

参数 listener

banner 广告关闭事件的回调函数

BannerAd.offClose(Function listener)

取消监听 banner 广告关闭事件

参数 listener

banner 广告关闭事件的回调函数

BannerAd.hide()

隐藏 banner 广告。

BannerAd.offLoad(Function listener)

移除 banner 广告加载事件的监听函数

参数 listener(Function listener)

onLoad 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function(res) {
  console.log(res);
};

BannerAd.onLoad(listener);
BannerAd.offLoad(listener); // 需传入与监听时同一个的函数对象

BannerAd.offError(Function listener)

移除 banner 广告错误事件的监听函数

参数 listener

onError 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function(res) {
  console.log(res);
};

BannerAd.onError(listener);
BannerAd.offError(listener); // 需传入与监听时同一个的函数对象

BannerAd.offResize(Function listener)

移除 banner 广告尺寸变化事件的监听函数

参数 listener

onResize 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function(res) {
  console.log(res);
};

BannerAd.onResize(listener);
BannerAd.offResize(listener); // 需传入与监听时同一个的函数对象

BannerAd.onError(Function listener)

监听 banner 广告错误事件。

参数 listener(Object res)

banner 广告错误事件的监听函数

属性类型说明
errMsgString错误信息
errCodeNumber错误码

BannerAd.onLoad(Function listener)

监听 banner 广告加载事件。

参数 listener

banner 广告加载事件的监听函数

BannerAd.show()

显示 banner 广告。

返回值 Promise

banner 广告显示操作的结果

条匹配 "" 的结果

    没有搜索到与 "" 相关的内容