我的书签
添加书签
移除书签BannerAd
banner 广告组件。banner 广告组件是一个原生组件，层级比上屏 Canvas 高，会覆盖在上屏 Canvas 上。banner 广告组件默认是隐藏的，需要调用 BannerAd.show() 将其显示。banner 广告会根据开发者设置的宽度进行等比缩放，缩放后的尺寸将通过 BannerAd.onResize() 事件中提供。
属性
Object style
banner 广告组件的样式。style 上的属性的值仅为开发者设置的值，banner 广告会根据开发者设置的宽度进行等比缩放，缩放后的真实尺寸需要通过 BannerAd.onResize() 事件获得。
| 属性 | 类型 | 说明 |
|---|---|---|
| left | number | banner 广告组件的左上角横坐标 |
| top | number | banner 广告组件的左上角纵坐标 |
| width | number | banner 广告组件的宽度。最小 300，最大至 屏幕宽度（屏幕宽度可以通过 qq.getSystemInfoSync() 获取）。 |
| height | number | banner 广告组件的高度 |
| realWidth | number | banner 广告组件经过缩放后真实的宽度 |
| realHeight | number | banner 广告组件经过缩放后真实的高度 |
方法
Promise BannerAd.show()
显示 banner 广告。
BannerAd.hide()
隐藏 banner 广告
BannerAd.destroy()
销毁 banner 广告
BannerAd.onResize(function callback)
监听 banner 广告尺寸变化事件
BannerAd.offResize(function callback)
取消监听 banner 广告尺寸变化事件
BannerAd.onLoad(function callback)
监听 banner 广告加载事件
BannerAd.offLoad(function callback)
取消监听 banner 广告加载事件
BannerAd.onError(function callback)
监听 banner 广告错误事件
BannerAd.offError(function callback)
取消监听 banner 广告错误事件
.show
Promise BannerAd.show()
显示 banner 广告。
返回值
Promise
banner 广告显示操作的结果
.onResize
BannerAd.onResize(function callback)
监听 banner 广告尺寸变化事件
参数
function callback
banner 广告尺寸变化事件的回调函数
参数
Object res
| 属性 | 类型 | 说明 |
|---|---|---|
| width | number | 缩放后的宽度 |
| height | number | 缩放后的高度 |
.onLoad
BannerAd.onLoad(function callback)
监听 banner 广告加载事件
参数
function callback
banner 广告加载事件的回调函数
.onError
BannerAd.onError(function callback)
监听 banner 广告错误事件
参数
function callback
banner 广告错误事件的回调函数
参数
Object res
| 属性 | 类型 | 说明 | 最低版本 |
|---|---|---|---|
| errMsg | string | 错误信息 | |
| errCode | number | 错误码 |
errCode 的合法值
| 值 | 说明 |
|---|---|
| 1000 | 后端接口调用失败 |
| 1001 | 参数错误 |
| 1002 | 广告单元无效 |
| 1003 | 内部错误 |
| 1004 | 无合适的广告 |
| 1005 | 广告组件审核中 |
| 1006 | 广告组件被驳回 |
| 1007 | 广告组件被封禁 |
| 1008 | 广告单元已关闭 |
.offResize
BannerAd.offResize(function callback)
取消监听 banner 广告尺寸变化事件
参数
function callback
banner 广告尺寸变化事件的回调函数
.offLoad
BannerAd.offLoad(function callback)
取消监听 banner 广告加载事件
参数
function callback
banner 广告加载事件的回调函数
.offError
BannerAd.offError(function callback)
取消监听 banner 广告错误事件
参数
function callback
banner 广告错误事件的回调函数
.hide
BannerAd.hide()
隐藏 banner 广告
.destroy
BannerAd.destroy()
销毁 banner 广告
