广告 - InterstitialAd - 《Taro v3.0 API文档》

方法
参数
API 支持度

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

方法

destroy

销毁插屏广告实例。

() => void

API 支持度

API	微信小程序	H5	React Native
InterstitialAd.destroy	✔️

offClose

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

(callback: OffCloseCallback) => void

参数	类型
callback	`OffCloseCallback`

API 支持度

API	微信小程序	H5	React Native
InterstitialAd.offClose	✔️

offError

取消监听插屏错误事件

(callback: OffErrorCallback) => void

参数	类型
callback	`OffErrorCallback`

API 支持度

API	微信小程序	H5	React Native
InterstitialAd.offError	✔️

offLoad

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

(callback: OffLoadCallback) => void

参数	类型
callback	`OffLoadCallback`

API 支持度

API	微信小程序	H5	React Native
InterstitialAd.offLoad	✔️

onClose

监听插屏广告关闭事件。

(callback: OnCloseCallback) => void

参数	类型
callback	`OnCloseCallback`

API 支持度

API	微信小程序	H5	React Native
InterstitialAd.onClose	✔️

onError

监听插屏错误事件。

(callback: OnErrorCallback) => void

参数	类型
callback	`OnErrorCallback`

API 支持度

API	微信小程序	H5	React Native
InterstitialAd.onError	✔️

onLoad

监听插屏广告加载事件。

(callback: OnLoadCallback) => void

参数	类型
callback	`OnLoadCallback`

API 支持度

API	微信小程序	H5	React Native
InterstitialAd.onLoad	✔️

load

加载插屏广告。

() => Promise<any>

API 支持度

API	微信小程序	H5	React Native
InterstitialAd.load	✔️

show

显示插屏广告。

错误码信息表

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

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

() => Promise<any>

API 支持度

API	微信小程序	H5	React Native
InterstitialAd.show	✔️

参数

OffCloseCallback

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

(res: CallbackResult) => void

参数	类型
res	`CallbackResult`

OffErrorCallback

插屏错误事件的回调函数

(res: CallbackResult) => void

参数	类型
res	`CallbackResult`

OffLoadCallback

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

(res: CallbackResult) => void

参数	类型
res	`CallbackResult`

OnCloseCallback

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

(res: CallbackResult) => void

参数	类型
res	`CallbackResult`

OnErrorCallback

插屏错误事件的回调函数

(result: OnErrorCallbackResult) => void

参数	类型
result	`OnErrorCallbackResult`

OnLoadCallback

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

(res: CallbackResult) => void

参数	类型
res	`CallbackResult`

OnErrorCallbackResult

参数	类型	说明
errCode	`1000 \| 1001 \| 1002 \| 1003 \| 1004 \| 1005 \| 1006 \| 1007 \| 1008`	错误码参考地址
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	✔️