BannerAd 创建banner广告组件 qq.createBannerAd(Object object)
BannerAd qq.createBannerAd(Object object)
创建 banner 广告组件。开发者工具 0.1.26 版本开始支持调试广告组件。
参数
Object object
| 属性 | 类型 | 默认值 | 必填 | 说明 | 最低版本 |
|---|---|---|---|---|---|
| adUnitId | string | 是 | 广告单元 id | ||
| style | Object | 是 | banner 广告组件的样式 | ||
| testDemoType | string | 65 | 否 | 指定要测试的广告规格，该属性仅在开发者工具有效 | 1.4.0 |
object.style 的结构
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| left | number | 是 | banner 广告组件的左上角横坐标 | |
| top | number | 是 | banner 广告组件的左上角纵坐标 | |
| width | number | 是 | banner 广告组件的宽度 | |
| height | number | 是 | banner 广告组件的高度 |
object.testDemoType 有效值
| 值 | 说明 |
|---|---|
| 65 | 1 文 1 图 |
| 184 | 1 文 1 图 |
| 193 | 0 文 1 图 |
| 194 | 2 文 1 图 |
| 210 | 1 文 1 图 |
| 285 | 1 文 3 图 |
返回值
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 | 错误码 |
.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 广告
错误码信息与解决方案表
错误码说明
| 代码 | 异常情况 | 理由 | 解决方案 |
|---|---|---|---|
| 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 重新打开对应广告位的展现。 |
其他API：
QQ小游戏 BannerAd 创建banner广告组件 API
QQ小游戏 AppBox 创建广告盒子组件 API
QQ小游戏 RewardedVideoAd 创建激励视频广告组件 API
使用方法：
接QQ小游戏小程序盒子广告sdk
接QQ小游戏Banner广告sdk
接QQ小游戏小程序视频广告sdk
