Skip to content

插屏 —— NovvyInterstitialAd ​

「一次性、全屏」广告,用法与激励视频几乎一致,唯一区别是没有 onUserEarnedReward。

对接流程 ​

NovvyAds.setContentContext(...)   // 短剧场景必需
        ↓
NovvyInterstitialAd(adUnitId)
        ↓
load()  →  onAdLoaded             // 就绪(或 onAdFailedToLoad)
        ↓
show()  →  onAdShowed             // 到达切换点时展示
        ↓
onAdDismissed                     // 关闭后自动 destroy

完整示例 ​

dart
final ad = NovvyInterstitialAd(adUnitId: 'your_ad_unit_id');

ad.onAdLoaded = () { /* 已就绪,可在切换点展示 */ };
ad.onAdShowed = () { /* 已展示 */ };
ad.onAdDismissed = () { /* 关闭 */ ad.destroy(); };
ad.onAdFailedToLoad = (e) => ad.destroy();

ad.load();                               // 提前预加载

// 到达切换点(如页面跳转、关卡结束)时再展示:
void onTransition() {
  if (ad.isReady) ad.show();
}

关闭后自动 destroy;未展示即放弃时手动调用 ad.destroy()。

事件回调 ​

除基类回调 onAdLoaded / onAdFailedToLoad 外,本类型的独有回调:

回调类型触发时机
onAdShowedvoid Function()?广告展示、曝光上报完成
onAdDismissedvoid Function()?广告关闭,触发后自动 destroy

onAdFailedToLoad(error) 的 error 取值见错误类型。回调统一在主 isolate(UI 线程) 触发。

本文档仅供技术对接使用,请勿外传。