1060+
创建 Banner 广告组件,如果已经创建过 Banner 广告组件,则返回已创建的广告组件
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
adUnitId | String | 是 | Banner 广告位标识 |
style | Object | 否 | Banner 广告组件的样式 |
代码示例:
let bannerAd = ad.createBannerAd({
adUnitId: 'xxx',
style:{
left:0,
top: 800,
width:1080
}
})
属性 | 类型 | 是否必填 | 说明 |
---|---|---|---|
left | Number | 否 | banner 广告组件的左上角横坐标 |
top | Number | 否 | banner 广告组件的左上角纵坐标 |
width | Number | 否 | banner 广告组件的宽度 |
height | Number | 否 | banner 广告组件的高度 |
Banner 广告组件的尺寸会根据开发者设置的宽度,即 style.width 进行等比缩放,缩放的范围是 designWidth * 50% 到 屏幕宽度。 开发者在创建 BannerAd 时设置宽高,也可以在创建后设置,如:
bannerAd.style.width = 1000
当 style.width 小于 designWidth 50% 时,会取作 designWidth 50%。 当 style.width 大于屏幕宽度时,会取作屏幕宽度。 在组件内部会以此值为基准,根据 Banner 广告的标准尺寸,进行缩放。 每当缩放发生且缩放后的尺寸不同时,通过 BannerAd.onResize() 注册的回调函数就会执行。回调函数的参数是一个包含 BannerAd 缩放后的宽和高的对象。BannerAd 的 style.realWidth 和 style.realHeight 到经过缩放后的宽和高。
bannerAd.onResize(res => {
console.log(res.width, res.height)
console.log(bannerAd.style.realWidth, bannerAd.style.realHeight)
})
Banner广告不设置位置,默认在屏幕底部。
Banner广告组件
加载展示banner广告,出错的时候回调 onError,分为加载和展示两个阶段,加载成功回调onLoad
banner 广告显示操作的结果
隐藏 banner 广告
banner 广告隐藏操作的结果
监听 banner 广告错误事件
代码示例:
bannerAd.onError((err)=>{
console.log(err)
})
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
errMsg | String | 是 | 错误信息 |
errCode | Number | 是 | 错误码 |
移除 banner 广告错误监听
监听 banner 广告加载事件,多个素材,每次加载新素材,都会进入这个回调
移除 banner 广告展示监听
监听 banner 广告关闭事件
移除 banner 关闭回调
监听 banner 广告尺寸变化事件
banner 广告尺寸变化事件的回调函数
Object res:
属性 | 类型 | 说明 |
---|---|---|
width | Number | 缩放后的宽度 |
height | Number | 缩放后的高度 |
取消监听 banner 广告尺寸变化事件
banner 广告尺寸变化事件的回调函数,可以为空
销毁 banner 广告