主题
插屏 —— NovvyInterstitialAd
「一次性、全屏」广告,用法与激励视频几乎一致,唯一区别是没有 onUserEarnedReward。
对接流程
NovvyAds.setContentContext(...) // 短剧场景必需
↓
new NovvyInterstitialAd(adUnitId)
↓
load() → onAdLoaded // 就绪(或 onAdFailedToLoad)
↓
show() → onAdShowed // 到达切换点时展示
↓
onAdDismissed // 关闭后自动 destroy方法:show() —— 展示广告,必须在 onAdLoaded 之后调用(未就绪时抛错)。
完整示例
ts
const ad = new NovvyInterstitialAd('your_ad_unit_id');
ad.onAdLoaded = () => { /* 已就绪,可在切换点展示 */ };
ad.onAdShowed = () => { /* 已展示 */ };
ad.onAdDismissed = () => { /* 关闭,已自动 destroy */ };
ad.onAdFailedToLoad = (e) => { ad.destroy(); };
ad.load(); // 提前预加载
// 到达切换点(如页面跳转、关卡结束)时再展示:
function onTransition() {
if (ad.isReady) ad.show();
}关闭后自动
destroy;未展示即放弃时手动调用ad.destroy()。
事件回调
除基类回调 onAdLoaded / onAdFailedToLoad 外,本类型的独有回调:
| 回调 | 类型 | 触发时机 |
|---|---|---|
onAdShowed | () => void | 广告已展示(不代表曝光已上报,见回调与曝光) |
onAdDismissed | () => void | 广告关闭,触发后自动 destroy |
onAdFailedToLoad(error) 的 error 取值见错误类型。回调统一在 JS 主线程 触发。