跳到主要内容

插屏广告

插屏广告组件是由客户端原生的图片、文本、视频控件组成的,层级最高,会覆盖在上屏 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()