毛毛力翻页器 (Page Turner)

将 Android 手机变成蓝牙翻页器，通过音量键控制阅读器翻页。

功能

• 蓝牙 HID 连接 — 手机模拟蓝牙键盘，阅读器配对后即可使用
• 音量键翻页 — 音量+ 上一页，音量- 下一页
• 熄屏翻页 — 屏幕关闭状态下音量键依然可用
• 后台翻页 — APP 切到后台不影响使用
• 锁屏翻页 — 锁屏状态下正常翻页
• 双击音量- — 快速切换自动翻页
• 自动翻页 — 支持固定间隔、随机间隔、习惯学习三种模式
• 任务模式 — 设定阅读时长目标，自动随机翻页完成
• 历史设备 — 记录连接过的设备，一键重连
• 断连重连 — 蓝牙断开后自动尝试重连
• 开机自连 — 打开 APP 自动连接上次使用的设备
• 电池优化 — 引导关闭电池优化，防止系统杀后台

技术实现

模块	方案
蓝牙 HID	BluetoothHidDevice API，模拟键盘发送 HID Report
音量键拦截	MediaSessionCompat + VolumeProviderCompat（setPlaybackToRemote）
熄屏翻页	静音 AudioTrack 持续播放 + MediaSession 保持活跃，系统在熄屏时仍路由音量键
CPU 唤醒	短时 PARTIAL_WAKE_LOCK（3 秒自动释放），避免触发厂商 Deathlock 检测
前台保活	ForegroundService（connectedDevice 类型）
UI	Jetpack Compose + Material 3

环境要求

• Android 10（API 29）及以上
• 蓝牙功能
• 目标设备需支持蓝牙 HID（键盘）连接

构建

./gradlew assembleDebug

Release 构建（需配置签名）：

./gradlew assembleRelease

使用方法

1. 在阅读器（Kindle、文石、墨案等）上打开蓝牙设置
2. 打开毛毛力翻页器 APP，点击「开始」
3. 在阅读器上搜索并配对「Page Turner」
4. 连接成功后，按手机音量键即可翻页

熄屏翻页

首次使用时，APP 会引导关闭电池优化。关闭后熄屏状态下音量键翻页即可正常工作。

版本记录

v1.0.1

• 新增熄屏翻页（屏幕关闭状态下音量键稳定翻页）
• 修复熄屏时音量键偶发失效
• 修复编辑头像后不实时刷新、保存后不显示

v1.0

• 蓝牙连接阅读器，手机变翻页器
• 音量键翻页，熄屏也能用
• 历史设备一键重连
• 断连自动重连
• 打开 APP 自动连接上次设备
• 后台稳定运行，不被系统杀掉

License

MIT