bannerAd qg.createBannerAd(Object object)

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

参数 Object object

属性	类型	必填	说明
adUnitId	string	是	Banner 广告位标识
style	Object	是（1070+）	Banner 广告组件的样式
adIntervals（1070+）	number	否	广告自动刷新的间隔时间，单位为秒，参数值必须大于等于 30（该参数不传入时 Banner 广告不会自动刷新）

style 的结构

属性	类型	必填	说明
left	number	是（1070+）	banner 广告组件的左上角横坐标
top	number	是（1070+）	banner 广告组件的左上角纵坐标
width	number	是（1070+）	banner 广告组件的宽度
height	number	是（1070+）	banner 广告组件的高度

返回值

bannerAd

Banner 广告组件

bannerAd.style（1070+）

属性，banner 广告组件的样式。style 上的属性的值仅为开发者设置的值，banner 广告会根据开发者设置的宽度进行等比缩放，缩放后的真实尺寸需要通过 bannerAd.onResize() 事件获得。 | 属性 | 类型 | 说明 | |------------|--------|-------------------------------------| | left | number | banner 广告组件的左上角横坐标 | | top | number | banner 广告组件的左上角纵坐标 | | width | number | banner 广告组件的宽度 | | height | number | banner 广告组件的高度 | | realWidth | number | banner 广告组件经过缩放后真实的宽度 | | realHeight | number | banner 广告组件经过缩放后真实的高度 |

Promise bannerAd.show()

展示 banner 广告

Promise (1090+)

展示 banner 广告的结果

bannerAd.hide()

隐藏 banner 广告

bannerAd.destroy()（1070+）

销毁 banner 广告

bannerAd.onResize(Function callback)

监听 banner 广告尺寸变化事件

参数 Function callback

banner 广告尺寸变化事件的回调函数

callback 回调函数参数 Object res

属性	类型	说明
width	Number	缩放后的宽度
height	Number	缩放后的高度

bannerAd.offResize(Function callback)

取消监听 banner 广告尺寸变化事件，callback 同 onResize 的 callback 一致

bannerAd.onLoad(Function callback)

监听 banner 广告加载事件，callback 无返回值

bannerAd.offLoad(Function callback)

取消监听 banner 广告加载事件，callback 无返回值

bannerAd.onError(Function callback)

监听 banner 广告错误事件

callback 回调函数的参数 Object res

属性	类型	说明
errMsg	String	错误信息
errCode	Number	错误码

errCode 值（1070+）

值	说明	最低版本
1000	后端接口调用失败
1001	参数错误
1002	广告单元无效
1003	内部错误
1004	无合适的广告
1005	广告组件审核中
1006	广告组件被驳回
1007	广告组件被封禁
1008	广告单元已关闭

bannerAd.offError(Function callback)

取消监听 banner 广告错误事件，callback 同 onError 的 callback 一致

bannerAd.onClose(Function callback)（废弃 1070+）

监听 banner 广告关闭事件

bannerAd.offClose(Function callback)（废弃 1070+）

移除 banner 关闭回调

支持明细

厂商	说明
OPPO	暂不支持 adIntervals 字段