BlockAd

积木广告组件。积木广告组件是一个原生组件,层级比上屏 Canvas 高,会覆盖在上屏 Canvas 上。积木广告组件默认是隐藏的,需要调用 BlockAd.show() 将其显示。积木广告可以选择展示1到5个广告,通过初始化积木广告的参数size来设置。此外,积木广告提供横屏和竖屏两种排版,积木广告不支持大小缩放,真实的尺寸大小将通过 BlockAd.onResize() 事件中提供。

8.3.9版本“广告与屏幕最小边距”将适配屏幕尺寸自动调整,安卓端统一单位为dp,需注意兼容8.3.6安卓版本。

8.3.9版本新增支持动态修改位置:

-安卓端,将会在修改位置后进行自动调整:若调整后位置摆放不下原定广告icon,则将自动减少展示icon个数,若icon个数<1,则将回调onError,不予展示;

-由于不同版本的差异,目前IOS端将会直接展示动态调整后的广告icon,如调整不当,广告icon的位置可能超出屏幕、造成展示异常,请在调整时确认积木icon位置正常展示。在8.4.1版本,IOS端将对齐安卓端支持自动调整。

属性

Object style

积木广告组件的样式。style 上的属性的值仅为开发者设置的值,积木广告会根据开发者设置的广告个数来决定广告尺寸,真实尺寸需要通过 BlockAd.onResize() 事件获得。

属性 类型 说明
left number 积木广告组件的左上角横坐标
top number 积木广告组件的左上角纵坐标

方法

Promise BlockAd.show()

显示积木广告。

BlockAd.hide()

隐藏积木广告

BlockAd.destroy()

销毁积木广告

BlockAd.onResize(function callback)

监听积木广告尺寸大小事件

BlockAd.offResize(function callback)

取消监听积木广告尺寸大小事件

BlockAd.onLoad(function callback)

监听积木广告加载事件

BlockAd.offLoad(function callback)

取消监听积木广告加载事件

BlockAd.onError(function callback)

监听积木广告错误事件

BlockAd.offError(function callback)

取消监听积木广告错误事件

.show

Promise BlockAd.show()

显示积木广告。

返回值

Promise

积木广告显示操作的结果

.onResize

BlockAd.onResize(function callback)

监听积木广告尺寸大小事件

参数

function callback

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

参数

Object res

属性 类型 说明
width number 积木广告的真实宽度
height number 积木广告的真实高度

.onLoad

BlockAd.onLoad(function callback)

监听积木广告加载事件

参数

function callback

积木广告加载事件的回调函数

.onError

BlockAd.onError(function callback)

监听积木广告错误事件

参数

function callback

积木广告错误事件的回调函数

参数

Object res

属性 类型 说明 最低版本
errMsg string 错误信息
errCode number 错误码

.offResize

BlockAd.offResize(function callback)

取消监听积木广告尺寸变化事件

参数

function callback

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

.offLoad

BlockAd.offLoad(function callback)

取消监听积木广告加载事件

参数

function callback

积木广告加载事件的回调函数

.offError

BlockAd.offError(function callback)

取消监听积木广告错误事件

参数

function callback

积木广告错误事件的回调函数

.hide

BlockAd.hide()

隐藏积木广告 (安卓839版本支持,目前请销毁后重新创建)

.destroy

BlockAd.destroy()

销毁积木广告

错误码信息与解决方案表

错误码说明

代码 异常情况 理由 解决方案
1000 后端错误调用失败 该项错误不是开发者的异常情况 一般情况下忽略一段时间即可恢复。
1001 参数错误 使用方法错误 可以前往 q.qq.com 确认具体教程(小程序和小游戏分别有各自的教程,可以在顶部选项中,“设计”一栏的右侧进行切换。
1002 广告单元无效 可能是拼写错误、或者误用了其他 APP 的广告 ID 请重新前往 q.qq.com 确认广告位 ID。
1003 内部错误 该项错误不是开发者的异常情况 一般情况下忽略一段时间即可恢复。
1004 无适合的广告 广告不是每一次都会出现,这次没有出现可能是由于该用户不适合浏览广告 属于正常情况,且开发者需要针对这种情况做形态上的兼容。
1005 广告组件审核中 你的广告正在被审核,无法展现广告 请前往 q.qq.com 确认审核状态,且开发者需要针对这种情况做形态上的兼容。
1006 广告组件被驳回 你的广告审核失败,无法展现广告 请前往 q.qq.com 确认审核状态,且开发者需要针对这种情况做形态上的兼容。
1007 广告组件被驳回 你的广告能力已经被封禁,封禁期间无法展现广告 请前往 q.qq.com 确认小程序广告封禁状态。
1008 广告单元已关闭 该广告位的广告能力已经被关闭 请前往 q.qq.com 重新打开对应广告位的展现。
1009 广告位置设置错误 该广告的位置设置导致展示不全 请重新调整广告的位置