BannerAd

banner 广告组件。banner 广告组件是一个原生组件，层级比普通组件高。banner 广告组件默认是隐藏的，需要调用 BannerAd.show() 将其显示。

style 中的 width / height 表示最大可用区域，广告在区域内水平居中、顶部对齐，不拉伸、不裁剪；left / top 表示该区域的左上角坐标。尺寸单位为逻辑像素（Android 为 dp，iOS 为 pt），无需乘除 pixelRatio，可通过 sud.getContainerInfo 查询容器尺寸与像素比。实际展示尺寸通过 BannerAd.onResize() 事件提供。

属性

Object style

banner 广告组件的样式。style.width / style.height 是开发者设置的最大可用区域，展示期间保持不变；style.realWidth / style.realHeight 是只读的实际展示尺寸，首次成功展示前为 0。

属性	类型	说明
left	number	最大容器左上角横坐标，逻辑像素
top	number	最大容器左上角纵坐标，逻辑像素
width	number	最大可用宽度，必须大于 0
height	number	最大可用高度，必须大于 0
realWidth	number	实际广告宽度，逻辑像素，只读；首次成功展示前为 0
realHeight	number	实际广告高度，逻辑像素，只读；首次成功展示前为 0

• 响应尺寸变化时：在 BannerAd.onResize() 监听函数中直接读取回调参数 width / height。
• 在其他游戏逻辑中查询实际尺寸时：读取 bannerAd.style.realWidth / bannerAd.style.realHeight；首次成功展示前为 0。

方法

• BannerAd.show() — 显示 banner 广告
• BannerAd.hide() — 隐藏 banner 广告
• BannerAd.destroy() — 销毁 banner 广告
• BannerAd.onResize(function listener) — 监听 banner 广告实际尺寸变化事件
• BannerAd.offResize(function listener) — 移除 banner 广告实际尺寸变化事件的监听函数
• BannerAd.onLoad(function listener) — 监听 banner 广告加载成功事件
• BannerAd.offLoad(function listener) — 移除 banner 广告加载成功事件的监听函数
• BannerAd.onError(function listener) — 监听 banner 广告加载或展示失败事件
• BannerAd.offError(function listener) — 移除 banner 广告加载或展示失败事件的监听函数