舞厅按曲计费计时器，支持音量键快捷操作、息屏自动计时、通知栏实时显示，即使在锁屏或后台也能稳定运行。
采用 半曲中点计费 模式：
| 场景（4分钟/曲 · ¥20） | 已跳时间 | 计费曲数 | 费用 |
|---|---|---|---|
| 刚开始 | 0 ~ 1:59 | 0 曲 | ¥0 |
| 跳过半曲 | 2:00 ~ 5:59 | 1 曲 | ¥20 |
| 跳过一曲半 | 6:00 ~ 9:59 | 2 曲 | ¥40 |
公式：计费曲数 = floor(已跳秒数 / 每曲秒数 + 0.5)
app/src/main/java/com/example/dancetimer/
├── data/
│ ├── db/ # Room 数据库（计价规则、历史记录）
│ ├── model/ # 数据实体（PricingRule, PriceTier, DanceRecord）
│ └── preferences/ # DataStore 用户偏好
├── service/
│ ├── TimerState.kt # 计时器状态（Idle / Running / Finished）
│ └── TimerForegroundService.kt # 核心前台服务
├── ui/
│ ├── navigation/ # 导航路由
│ ├── theme/ # 主题色彩 / 字体
│ ├── viewmodel/ # ViewModel 层
│ └── screen/ # Compose 页面（首页、历史、规则编辑、设置等）
├── util/ # 计费引擎、音量键检测、震动、静音播放
└── widget/ # 桌面小组件
# 克隆项目
git clone https://github.com/JamesSmith888/DanceTimer.git
cd DanceTimer
# 编译 Debug APK
./gradlew assembleDebug
# 安装到设备
adb install -r app/build/outputs/apk/debug/app-debug.apk环境要求：
- Android Studio Ladybug 或更高版本
- JDK 11+
- Android SDK 35
针对国产手机（OPPO / realme / OnePlus / 小米等）的后台限制做了专项适配：
- 双重计时机制 — Handler（1 秒主循环）+ AlarmManager（30 秒备份唤醒），防止进程被冻结后计时停滞
- 静音音频流 — 零振幅 PCM 播放保持 MediaSession 激活，确保锁屏音量键路由到 App
- 电池优化引导 — 内置图文指引，帮助用户关闭电池优化以保证后台稳定运行
MIT