banner广告
banner广告组件是由客户端原生的图片、文本、视频控件组成的,层级最高,会覆盖在上屏 Canvas 上。 开发者可以调用 mgtv.createBannerAd 创建banner广告组件。
创建
banner广告组件默认是隐藏的,因此可以提前创建,提前初始化组件。
let bannerAd = mgtv.createBannerAd({
adUnitId: 'xxxx',
style: {
left: 10, //逻辑像素为单位,mgtv.getWindowInfo().screenWidth/mgtv.getWindowInfo().pixelRatio (表示屏幕横坐标中心)
top: 76, //逻辑像素为单位,mgtv.getWindowInfo().screenHeight/mgtv.getWindowInfo().pixelRatio (表示屏幕纵坐标中心)
width: 180 //建议在180-220之间
}
})
为避免滥用广告资源,目前每个用户每天可观看广告的次数有限。
显示
在组件创建后,在触发广告显示时,需要调用 bannerAd.show() 触发拉取、显示广告。
bannerAd.show()
如果拉取、显示广告成功,则显示广告。
如果拉取、显示失败,通过 bannerAd.onError() 注册的回调函数会执行,回调函数的参数是一个包含错误信息的对象。
bannerAd.onError(err => {
console.log(err)
})
隐藏
同时,开发者可以调用 bannerAd.hide() 进行隐藏。
bannerAd.hide()
用户也可以主动关闭banner广告。
监听用户关闭广告
如果广告被关闭,通过 bannerAd.onClose() 注册的回调函数会执行,回调函数没有参数传递。
bannerAd.onClose(()=> {
console.log("close");
})
销毁
需要调用 bannerAd.destroy()销毁banner广告组件。
bannerAd.destroy()