App端开屏广告倒计时必须由原生层托管,因onLaunch中setTimeout会被原生容器回收JS线程而中断;JS层仅传递minDuration、skipable等参数并响应关闭回调,禁用所有异步清理操作。

App 端开屏广告的倒计时不能靠 setTimeout 或 setInterval 在 JS 层实现,否则冷启动后倒计时刚跑两秒就中断——这是原生容器回收 JS 线程导致的,不是代码写错了。
为什么 onLaunch 里的 setTimeout 倒计时会失效
App 启动流程中,原生层(Android Activity / iOS ViewController)在首页 Webview 渲染完成前就会销毁 JS 上下文。你写的 setTimeout(() => { uni.navigateTo(...) }, 3000) 很可能在 1200ms 时就被强制终止,控制台还不会报错。
- 现象:广告图刚显示,页面就闪跳到首页,或卡在白屏/黑屏
- 只在 App 端(iOS 尤其明显)发生,H5 和小程序不受影响
-
onLaunch、onShow、甚至pages/splash/splash.vue的mounted都不安全 - uni-ad 后台配置的倒计时是原生级的,和你的 JS 定时器完全无关
真机调试时看到“黑屏→白屏→广告页”三段式怎么办
这不是倒计时问题,而是原生启动图(splash.png)和 Vue 页面之间的渲染断层。你无法控制原生图消失时刻,但可以避免在它之后立刻塞一个没准备好的 Vue 页面。
- 把
pages/splash/splash.vue设为首页,并在onLoad里用setTimeout(..., 100)延迟初始化,给 Webview 渲染留缓冲 - 页面样式必须用
position: fixed; top: 0; left: 0; width: 100vw; height: 100vh;全屏覆盖,别依赖uni.getSystemInfo动态计算 - 禁用所有下拉刷新、导航栏、tabBar,避免视觉穿帮
- 如果用了
uni.showLoading,跳转前务必调用uni.hideLoading(),否则遮罩残留
想自定义倒计时逻辑(如加载完图片才开始计时)必须走原生桥接
uni-app 官方 uni-ad 插件不开放动态时长控制接口。若需“图片加载完成 + 最少展示 3 秒 + 用户可跳过”,只能自己封装原生模块并用 uni.requireNativePlugin 调用。
- Android 需实现
SplashAdManager,iOS 需实现UNISplashAdView - JS 层只传参:
minDuration(单位 ms)、skipable(布尔)、imageUrl(CDN 地址) - 回调里统一处理跳转:
uni.navigateTo({ url: '/pages/index/index' }),且不能再加任何异步操作 - 切忌在回调里再调一次
setTimeout,原生已保证最小展示时长,JS 层只需响应关闭事件
最易被忽略的一点:广告关闭回调触发时,页面可能还未完全卸载,onUnload 里若有异步请求或 uni.showToast,会干扰原生销毁流程,导致下次启动广告异常。所有清理动作必须同步、无副作用。











