跳到主要内容

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()