【uni-app 计时器切后台还想显示倒计时?小程序做不到的部分,Android App 用悬浮窗补上】
拿一个专注计时工具举例:先用 uni-app 做抖音小程序,再用同一套代码出 Android App。这类工具常见的需求是,用户切出去回个消息,也想知道还剩几分钟。
这篇记录一下怎么处理:小程序端接受限制、做好回来后的状态恢复;App 端用系统悬浮窗把剩余时间显示在桌面上。
【小程序端:先把计时本身做对】
小程序切到后台后,定时器会被暂停或降频,不能指望 setInterval 一直跑。计时不要累加 tick,改成记结束时间戳:
—— 代码 ——
// store/timer.js
export const timer = {
endAt: 0,
start (minutes) {
this.endAt = Date.now() + minutes * 60 * 1000
uni.setStorageSync('timer_endAt', this.endAt)
},
remain () {
return Math.max(0, this.endAt - Date.now())
}
}
—— 代码结束 ——
页面 onShow 里从缓存恢复 endAt 再算剩余时间,切多久回来都是准的。这一步两端通用。
小程序跑在抖音里,界面只能画在小程序自己的页面内,退出以后在桌面或其他 App 上显示内容,这在小程序里没有对应能力。所以小程序端到这里就够了。
【App 端:为什么 cover-view 不行】
App 版容易想到的是写个 position: fixed 的悬浮按钮,或者用 cover-view、subNVue。这些都画在 App 自己的窗口里,App 一退到后台就看不见了。
要盖在其他应用上面,Android 要用 WindowManager 加一个 TYPE_APPLICATION_OVERLAY 窗口,需要 SYSTEM_ALERT_WINDOW 权限。这个权限不能用普通的运行时弹窗申请,要跳到系统的「显示在其他应用上层」设置页让用户手动打开。浮窗要在后台稳定显示,还得配一个前台服务和一条通知,Android 13 起通知权限要运行时申请。
这部分原生代码可以自己用 UTS 写,这里用的是插件市场的一个 UTS 插件。下面的代码都包在条件编译里,小程序包不会带进去。
【接入步骤】
1. 检查悬浮窗权限
—— 代码 ——
// #ifdef APP-ANDROID || APP-PLUS
import * as floatWin from '@/uni_modules/aiko-float-window'
export function ensureOverlay () {
return new Promise((resolve) => {
floatWin.checkOverlayPermission((res) => {
if (res['data']?.['status'] === true) return resolve(true)
floatWin.toOverlayPermissionPage(() => {})
resolve(false)
})
})
}
// #endif
—— 代码结束 ——
用户从设置页回来后,在 onShow 里再检查一次。权限要在用户主动点了「切后台显示倒计时」这类开关之后再去申请,并先说明用途。
2. 用户离开 App 时显示悬浮球
—— 代码 ——
// App.vue
onHide () {
// #ifdef APP-ANDROID || APP-PLUS
if (timer.remain() > 0 && settings.floatOn) {
floatWin.show({
id: 'timer',
template: 'call', // 内置模板,样式以插件文档为准
title: '专注中',
subtitle: fmt(timer.remain()),
ballText: '专注',
expanded: false,
buttons: [{ id: 'stop', text: '结束' }],
notifyTitle: '计时进行中',
notifyContent: '点击返回 App'
}, (res) => {
if (res['code'] === -2) settings.floatOn = false // 未授予悬浮窗权限
})
}
// #endif
}
—— 代码结束 ——
3. 每秒刷新剩余时间
update 只合并传入的字段,没传的保持原值,可选字段别显式传 null:
—— 代码 ——
tick = setInterval(() => {
const ms = timer.remain()
if (ms <= 0) {
floatWin.hideById({ id: 'timer' }, () => {})
clearInterval(tick)
return
}
floatWin.update({ id: 'timer', subtitle: fmt(ms) }, () => {})
}, 1000)
—— 代码结束 ——
4. 处理按钮和回到前台
—— 代码 ——
floatWin.registerListener((evt) => {
const d = evt['data']
if (d?.['type'] === 'button' && d['buttonId'] === 'stop') {
timer.endAt = 0
floatWin.hideById({ id: 'timer' }, () => {})
}
})
// App.vue onShow 里
floatWin.hideById({ id: 'timer' }, () => {})
—— 代码结束 ——
回到 App 就收掉浮窗,不要让它和页面里的计时同时显示。
【常见问题】
现象 原因 / 处理
show 返回 -2 没开悬浮窗权限,调 toOverlayPermissionPage
切出去一会浮窗没了 检查通知权限;部分 ROM 要允许后台运行,还有一层自己的悬浮窗开关
改了插件没效果 重新制作自定义调试基座,热更新不生效
全屏视频里看不到 部分播放器全屏时会压住叠加层,属于系统限制
【支持范围和合规】
- 插件只支持 Android(uni-app 4.23+、uni-app x 4.62+,Android 5.0 及以上),iOS、鸿蒙和小程序都不支持。APP-PLUS 会编进 iOS 包,iOS 端要把开关隐藏掉。
- 悬浮窗会盖在其他应用上,要经用户授权后开启,隐私政策里写明用途;上架应用商店时按要求申报悬浮窗权限。
- 只做悬浮球和面板时用不到电话状态、使用情况访问这类权限,不需要就别申请。
App 端用的插件在 DCloud 插件市场搜「Android全局浮窗」,付费插件可以先试用。
插件详情页:https://ext.dcloud.net.cn/plugin?id=29432