积木广告组件。积木广告组件是一个原生组件,层级比上屏 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端将对齐安卓端支持自动调整。
积木广告组件的样式。style 上的属性的值仅为开发者设置的值,积木广告会根据开发者设置的广告个数来决定广告尺寸,真实尺寸需要通过 BlockAd.onResize() 事件获得。
属性 | 类型 | 说明 |
---|---|---|
left | number | 积木广告组件的左上角横坐标 |
top | number | 积木广告组件的左上角纵坐标 |
显示积木广告。
隐藏积木广告
销毁积木广告
监听积木广告尺寸大小事件
取消监听积木广告尺寸大小事件
监听积木广告加载事件
取消监听积木广告加载事件
监听积木广告错误事件
取消监听积木广告错误事件
显示积木广告。
积木广告显示操作的结果
监听积木广告尺寸大小事件
积木广告尺寸变化事件的回调函数
Object res
属性 | 类型 | 说明 |
---|---|---|
width | number | 积木广告的真实宽度 |
height | number | 积木广告的真实高度 |
监听积木广告加载事件
积木广告加载事件的回调函数
监听积木广告错误事件
积木广告错误事件的回调函数
Object res
属性 | 类型 | 说明 | 最低版本 |
---|---|---|---|
errMsg | string | 错误信息 | |
errCode | number | 错误码 |
取消监听积木广告尺寸变化事件
积木广告尺寸变化事件的回调函数
取消监听积木广告加载事件
积木广告加载事件的回调函数
取消监听积木广告错误事件
积木广告错误事件的回调函数
隐藏积木广告 (安卓839版本支持,目前请销毁后重新创建)
销毁积木广告
错误码说明
代码 | 异常情况 | 理由 | 解决方案 |
---|---|---|---|
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 | 广告位置设置错误 | 该广告的位置设置导致展示不全 | 请重新调整广告的位置 |
← InterstitialAd 广告数据接口 →