uni-app 计时器切后台显示倒计时:Android App 用悬浮窗补上
271 浏览2026年10月22日作者:User7699303358720606218
【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
最后一次编辑于 2026 年 10 月 22 日
共 0 条评论

相关文章

专题推荐

热门文章

热门问答