插屏广告
插屏广告组件是由客户端原生的图片、文本、视频控件组成的,层级最高,会覆盖在上屏 Canvas 上。
开发者可以调用 mgtv.createInterstitialAd 创建插屏广告组件。
创建
插屏广告组件默认是隐藏的,因此可以提前创建,提前初始化组件。
const interstitialAd = mgtv.createInterstitialAd({ adUnitId: 'xxxx' })
为避免滥用广告资源,目前每个用户每天可观看广告的次数有限。
显示
组件创建后,在触发广告显示时,需要调用 interstitialAd.show() 触发拉取、显示广告。
interstitialAd.show()
如果拉取、显示广告成功,则显示广告。
如果拉取、显示失败,通过 interstitialAd.onError() 注册的回调函数会执行,回调函数的参数是一个包含错误信息的对象。
interstitialAd.onError(err => {
console.log(err)
})
用户可以主动关闭插屏广告,才会关闭。开发者不可控制插屏广告组件的隐藏。
监听用户关闭
如果广告被关闭,通过 interstitialAd.onClose() 注册的回调函数会执行,回调函数没有参数传递。
interstitialAd.onClose(() => {
console.log("close");
})
销毁
需要调用 interstitialAd.destroy()销毁插屏广告组件。 创建新的插屏广告组件之前,需要先调用 interstitialAd.destroy()销毁之前创建的插屏广告组件,否则会出现广告加载失败的情况。
interstitialAd.destroy()