Skip to content
45944831Public

About

毫秒悬浮时钟 · Android 悬浮窗毫秒级时间显示(多源校时 / 后台常驻 / 外观可调)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

毫秒悬浮时钟 · msclock

Android 悬浮窗毫秒时钟。走时按网络校时后的偏移锚定,可挂在桌面/任意应用之上, 支持 16 个时间源校准(含 GNSS 与系统网络时间)、外观调节与拖动位置记忆。

功能

  • 毫秒显示:HH:MM:SS.mmm,Choreographer 单循环驱动,默认 30fps(可切 60fps)。 可在设置中关闭毫秒进入秒级省电模式(停 vsync,每秒对齐唤醒一次,空闲 CPU 接近 0)。
  • 多源校时:淘宝 / 天猫 / 京东 / 美团 / 饿了么 / 唯品会 / 拼多多 / 哔哩哔哩 / 快手 / 小红书 / 支付宝 / 12306 / 云闪付 / 阿里云 NTP 共 14 个网络源,外加 GNSS 授时(API 29+, 室外微秒级、无需网络)与系统网络时间(API 33+)两个可选系统源,按不确定度加权合成; NTP 并行请求阿里云/腾讯/cn.ntp 取中位 offset,校验 rootDelay/rootDispersion/serverResponse, 测时与调度全走单调钟,系统跳钟不污染校时结果; 快校 3 源约 0.3s,全量约 2.6–3.4s(启动后 6s 自动补一轮),失败按 60s→10min 退避。
  • 无网/异常可诊断:校时前用 NET_CAPABILITY_VALIDATED 预检,无网直接给结论不发请求; 全失败时按占比区分「未连接网络 / 域名解析失败 / SSL 握手失败 / 全部源超时」。
  • 抗抖动与守时:校时结果按 1/unc² 置信度融合(超 3σ 判为真实跳变直接采纳), 毫秒位不随测量噪声跳动;用最近 8 次结果拟合晶振频偏,两次校时之间按 ppm 补偿走时。
  • 源健康度:每源记录成功率与精度画像,快校动态选最优 3 源,连续失败的源指数退避。
  • 不受系统时间影响:以 elapsedRealtime 锚定,手动改系统时间不会让悬浮钟跳变; 校时缓存同样以单调钟计时有效期,小步改钟不会让过期缓存生效。
  • 单源可选:时间源页可指定某个平台,失败时回退该源上次成功偏移。
  • 外观可调:50%–200% 缩放(滑杆或双指捏合,按屏幕宽高自动封顶)、30%–100% 透明度、30/60fps。
  • 位置记忆:拖动即保存,越界实时钳制,松手靠近左右边缘自动磁吸; 重启后位置/外观/时间源/手动微调均保留。
  • 熄屏省电:熄屏暂停渲染与周期校时,亮屏立即补一帧并补校(实测熄屏 0.0% CPU)。
  • 权限自检:悬浮窗权限被撤销后服务自动退出,不留假"运行中"状态。

使用

  1. 安装后打开应用,点「开始悬浮时钟」,按提示授予「显示在其他应用上层」。
  2. 悬浮窗可拖动;长按 1 秒关闭;单击打开应用。
  3. 主界面可手动微调 ±ms;「时间源」切换平台;「悬浮窗设置」调大小/透明度/刷新率/毫秒开关。
  4. 悬浮窗双指捏合缩放;拖动松手吸附边缘;长按 1 秒关闭。
  5. 通知栏常驻通知可一键关闭。

构建

手工构建链(aapt2 + javac + d8 + zipalign + apksigner),不依赖 Gradle:

# 需要 Android SDK build-tools 34.0.0 / platforms/android-34 与 JDK 8+
ANDROID_SDK=/d/SDK bash build_apk.sh

产物输出到仓库上一级目录 毫秒悬浮时钟.apk。首次构建会自动生成 debug.keystore; 升级安装必须沿用同一签名,请自行备份该密钥库。

校时算法的纯 JVM 单测(无需 Android SDK / JUnit):

bash tests/jvm/run_tests.sh     # 33 项断言:区间交集/加权/中位数/NTP时间戳/时间格式化/结果融合/频偏拟合

GitHub Actions(.github/workflows/ci.yml)在 push/PR 时自动跑单测 + 手工链构建 APK。

真机测试

自动化启停通道(需 shell/root,普通应用无权使用):

adb shell am broadcast -a com.wb.msclock.action.CMD \
  -n com.wb.msclock/.CmdReceiver --receiver-include-background --es cmd start
adb shell am broadcast -a com.wb.msclock.action.CMD \
  -n com.wb.msclock/.CmdReceiver --receiver-include-background --es cmd stop

权限说明

权限 用途
SYSTEM_ALERT_WINDOW 显示悬浮窗
FOREGROUND_SERVICE / POST_NOTIFICATIONS 常驻通知,保证后台走时
INTERNET / ACCESS_NETWORK_STATE 校时(仅访问上述时间源)

无账号、无统计、无广告,不上传任何本地数据。

更新记录

见 CHANGELOG.md。

About

毫秒悬浮时钟 · Android 悬浮窗毫秒级时间显示(多源校时 / 后台常驻 / 外观可调)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages