InterstitialAd
插屏广告组件。插屏广告组件是一个原生组件,层级比普通组件高。插屏广告组件每次创建都会返回一个全新的实例(小程序端的插屏广告实例不允许跨页面使用),默认是隐藏的,需要调用 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 | ✔️ |