Android 悬浮窗毫秒时钟。走时按网络校时后的偏移锚定,可挂在桌面/任意应用之上, 支持 16 个时间源校准(含 GNSS 与系统网络时间)、外观调节与拖动位置记忆。
- 包名:
com.wb.msclock - 最低系统:Android 8.0(API 26),目标 API 33
- 安装包:dist/毫秒悬浮时钟.apk
- 毫秒显示:
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 秒关闭;单击打开应用。
- 主界面可手动微调 ±ms;「时间源」切换平台;「悬浮窗设置」调大小/透明度/刷新率/毫秒开关。
- 悬浮窗双指捏合缩放;拖动松手吸附边缘;长按 1 秒关闭。
- 通知栏常驻通知可一键关闭。
手工构建链(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。
- 报告:docs/真机深度测试报告_2026-10-28.md · docs/真机深度测试报告_2026-11-14.md(v1.2)
- 脚本:tests/(OPPO PEYM00 / ColorOS 13 / Android 13 实测;截图断言 + dumpsys 校验)
- 结果:132 项检查,PASS 130 / WARN 2 / FAIL 0(WARN:ColorOS 上划清任务即强停属 OEM 策略; 启停循环后线程数瞬时波动,150s 后回落至基线)。v1.1 复测:深度 27/27、UI 32/32、校时网络 13/13。
自动化启停通道(需 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。