title: InterstitialAd

sidebar_label: InterstitialAd

插屏广告组件。插屏广告组件是一个原生组件，层级比普通组件高。插屏广告组件每次创建都会返回一个全新的实例（小程序端的插屏广告实例不允许跨页面使用），默认是隐藏的，需要调用 InterstitialAd.show() 将其显示。

参考文档

方法

destroy

销毁插屏广告实例。

支持情况：InterstitialAd - 图1 InterstitialAd - 图2 InterstitialAd - 图3

参考文档

  1. () => void

offClose

取消监听插屏广告关闭事件

支持情况：InterstitialAd - 图4 InterstitialAd - 图5 InterstitialAd - 图6

参考文档

  1. (callback: OffCloseCallback) => void
参数 类型
callback OffCloseCallback

offError

取消监听插屏错误事件

支持情况：InterstitialAd - 图7 InterstitialAd - 图8 InterstitialAd - 图9

参考文档

  1. (callback: OffErrorCallback) => void
参数 类型
callback OffErrorCallback

offLoad

取消监听插屏广告加载事件

支持情况：InterstitialAd - 图10 InterstitialAd - 图11 InterstitialAd - 图12

参考文档

  1. (callback: OffLoadCallback) => void
参数 类型
callback OffLoadCallback

onClose

监听插屏广告关闭事件。

支持情况：InterstitialAd - 图13 InterstitialAd - 图14 InterstitialAd - 图15

参考文档

  1. (callback: OnCloseCallback) => void
参数 类型
callback OnCloseCallback

onError

监听插屏错误事件。

支持情况：InterstitialAd - 图16 InterstitialAd - 图17 InterstitialAd - 图18

参考文档

  1. (callback: OnErrorCallback) => void
参数 类型
callback OnErrorCallback

onLoad

监听插屏广告加载事件。

支持情况：InterstitialAd - 图19 InterstitialAd - 图20 InterstitialAd - 图21

参考文档

  1. (callback: OnLoadCallback) => void
参数 类型
callback OnLoadCallback

load

加载插屏广告。

支持情况：InterstitialAd - 图22 InterstitialAd - 图23 InterstitialAd - 图24

参考文档

  1. () => Promise<any>

show

显示插屏广告。

错误码信息表

如果插屏广告显示失败，InterstitialAd.show() 方法会返回一个rejected Promise，开发者可以获取到错误码及对应的错误信息。

代码 异常情况 理由
2001 触发频率限制 小程序启动一定时间内不允许展示插屏广告
2002 触发频率限制 距离小程序插屏广告或者激励视频广告上次播放时间间隔不足，不允许展示插屏广告
2003 触发频率限制 当前正在播放激励视频广告或者插屏广告，不允许再次展示插屏广告
2004 广告渲染失败 该项错误不是开发者的异常情况，或因小程序页面切换导致广告渲染失败
2005 广告调用异常 插屏广告实例不允许跨页面调用

支持情况：InterstitialAd - 图25 InterstitialAd - 图26 InterstitialAd - 图27

参考文档

  1. () => Promise<any>

参数

OffCloseCallback

插屏广告关闭事件的回调函数

  1. (res: TaroGeneral.CallbackResult) => void
参数 类型
res TaroGeneral.CallbackResult

OffErrorCallback

插屏错误事件的回调函数

  1. (res: TaroGeneral.CallbackResult) => void
参数 类型
res TaroGeneral.CallbackResult

OffLoadCallback

插屏广告加载事件的回调函数

  1. (res: TaroGeneral.CallbackResult) => void
参数 类型
res TaroGeneral.CallbackResult

OnCloseCallback

插屏广告关闭事件的回调函数

  1. (res: TaroGeneral.CallbackResult) => void
参数 类型
res TaroGeneral.CallbackResult

OnErrorCallback

插屏错误事件的回调函数

  1. (result: OnErrorCallbackResult) => void
参数 类型
result OnErrorCallbackResult

OnLoadCallback

插屏广告加载事件的回调函数

  1. (res: TaroGeneral.CallbackResult) => void
参数 类型
res TaroGeneral.CallbackResult

OnErrorCallbackResult

参数 类型 说明
errCode string or number or symbol 错误码
参考地址
errMsg string 错误信息

API 支持度

API 微信小程序 H5 React Native
InterstitialAd.destroy ✔️
InterstitialAd.offClose ✔️
InterstitialAd.offError ✔️
InterstitialAd.offLoad ✔️
InterstitialAd.onClose ✔️
InterstitialAd.onError ✔️
InterstitialAd.onLoad ✔️
InterstitialAd.load ✔️
InterstitialAd.show ✔️