QQ小游戏 AppBox 创建广告盒子组件 API

AppBox QQ小游戏创建广告盒子组件 qq.createAppBox(Object object)

---

AppBox qq.createAppBox(Object object)

创建广告盒子组件。基础库 1.7.1 版本开始支持广告盒子组件，开发者工具 0.1.28 版本开始支持调试。

参数

Object object

属性	类型	默认值	必填	说明
adUnitId	string		是	广告单元 id

#返回值

#AppBox

广告盒子组件

广告盒子组件是一个原生组件，层级比普通组件高。广告盒子是一个单例（小游戏端是全局单例，小程序端是页面内单例，在小程序端的单例对象不允许跨页面使用）。

默认是隐藏的，调用 AppBox.load()加载数据，AppBox.show() 将其显示。 AppBox.destroy()销毁实例，销毁后需要重新调用qq.createAppBox()创建实例。

---

方法

Promise AppBox.load()

加载广告盒子

Promise AppBox.show()

显示广告盒子

Promise AppBox.destroy()

销毁广告盒子

AppBox.onClose(function callback)

监听用户点击 关闭广告 按钮的事件

AppBox.offClose(function callback)

取消监听用户点击 关闭广告 按钮的事件

.load

Promise AppBox.load()

隐藏广告盒子

返回值

Promise

广告盒子加载数据的结果

.show

Promise AppBox.show()

显示广告盒子

返回值

Promise

广告盒子显示操作的结果

.destroy

Promise AppBox.destroy()

销毁广告盒子，销毁后才能重新创建

返回值

Promise

广告盒子销毁操作的结果

.onClose

AppBox.onClose(function callback)

监听用户点击 关闭广告 按钮的事件

参数

function callback

用户点击 关闭广告 按钮的事件的回调函数

.offClose

AppBox.offClose(function callback)

取消监听用户点击 关闭广告 按钮的事件

参数

function callback

用户点击 关闭广告 按钮的事件的回调函数

---

错误码信息与解决方案表

错误码说明

代码	异常情况	理由	解决方案
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小游戏小程序 AppBox 盒子广告sdk
接QQ小游戏 BannerAd 广告sdk
接QQ小游戏小程序 RewardedVideoAd 激励视频广告sdk

---

---