一个用 Flutter 开发的跨平台 BLE 心率监控与推送工具。连接心率设备后，可将实时 BPM、在线状态与心率百分比同步到 HTTP/WS、OSC、MQTT 等链路，方便在桌面端或周边应用中联动使用。
- BLE 扫描与连接：自动过滤无关广播，优先匹配心率服务/常见穿戴品牌。
- 智能自动重连：记忆最近成功设备，断连或心率长时间无更新时自动重连。
- 实时展示：BPM、上次更新时间、RSSI 信号强度；RSSI 轮询与刷新间隔一致。
- 多协议推送：HTTP/WS、OSC、MQTT 任意组合启用，统一 JSON payload。
- 调试视图：查看附近广播、Service UUID、RSSI、厂商数据长度。
- 桌面端体验：Windows/macOS/Linux 固定竖屏窗口；Windows 支持托盘最小化。
- Android 常驻通知：连接后在通知栏显示心率与连接状态。
- 常驻心率推送：家里/工作室有一台不关机的 Mac mini 或 Windows 主机，手表常开心率广播，回到范围内即可自动连接并持续推送。
- VRChat/自定义程序联动：通过 OSC 或 HTTP/WS/MQTT 订阅心率，用于状态显示、动画驱动或自定义交互。
| 首页 | 配置页 |
|---|---|
 |
 |
- 启动应用后点击“重新扫描”。
- 选择心率设备并连接。
- 在配置页填写推送目标（HTTP/WS、OSC 或 MQTT），保存后即可推送。
若设备仅广播心率但不支持连接，仍可在“广播调试”视图中查看数据与信号，但推送仅在连接并订阅特征后触发。
- HTTP：对
http(s)://目标发送 JSON（POST，超时 3 秒）。 - WebSocket：对
ws(s)://目标发送 JSON 文本，连接断开后会自动重连。 - OSC：填写
host:port后通过 UDP 发送；支持 bool/int/float 与 ChatBox 文本。 - MQTT：填写 Broker 后启用，支持端口/Topic/用户名/密码/Client ID，QoS 1 发布。
所有协议发送相同的 JSON payload。
- 心率事件
{
"event": "heartRate",
"heartRate": 85,
"percent": 0.42,
"connected": true,
"device": "Polar H10",
"timestamp": "2025-12-12T09:00:00.000Z"
}- 连接事件
{
"event": "connection",
"connected": false,
"device": "Polar H10",
"timestamp": "2025-12-12T09:05:00.000Z"
}percent = heartRate / 最大心率，范围 0~1。
| 配置项 | 说明 | 默认 |
|---|---|---|
| HTTP/WS 推送地址 | 为空关闭；支持 http(s)/ws(s) |
空 |
| OSC 目标地址 | host:port；为空关闭；UI 预填推荐值 |
空（推荐 127.0.0.1:9000） |
| OSC 路径：在线状态 | 发送 bool | /avatar/parameters/hr_connected |
| OSC 路径：当前心率 | 发送 int BPM | /avatar/parameters/hr_val |
| OSC 路径：心率百分比 | 发送 float 0~1 | /avatar/parameters/hr_percent |
| OSC ChatBox 开关 | 开启后向 /chatbox/input 推送心率文本 |
关闭 |
| OSC ChatBox 文本 | 支持 {hr}/{percent}；最多 144 字符 / 9 行 |
💓{hr} |
| MQTT Broker | 为空关闭；可写 mqtt://host:port 或纯 host |
空 |
| MQTT 端口 | Broker 未包含端口时生效 | 1883 |
| MQTT Topic | 发布 JSON payload | hr_push |
| MQTT 用户名/密码 | 可选 | 空 |
| MQTT Client ID | 为空自动生成 | 空 |
| 最大心率 | 用于计算百分比 | 200 |
| 推送/刷新间隔 (ms) | 控制 UI 刷新、推送节流、RSSI 轮询 | 1000 |
- 推荐搭配默认 OSC 参数插件：booth.pm/zh-cn/items/5531594
- 也可在 Avatar 参数中自行监听上述 OSC 路径。
蓝牙广播发送端
- Garmin Enduro 2（佳明手表，蓝牙广播推送）
- Xiaomi Smart Band 9（小米手环9，更新到1.3.206+固件后在 设置-心率广播 手动开启）(调研小米手环8以下版本的设备仍不支持或待测试)
蓝牙广播接收端
- iPhone 15 Pro（无证书可自行签名）
- OnePlus Ace（ColorOS / Android 14）
- MacBook Pro M5（macOS Tahoe 26.1）
- Windows（B450I GAMING PLUS AC 主板，自带蓝牙）
- Android：需要 BLE 扫描/连接权限（Android 12+ 无需定位，11 及以下需定位权限）。Android 13+ 若想显示常驻通知卡片，请允许通知权限。
- ColorOS/部分国产 ROM：需在系统设置中打开应用通知，并允许后台运行/自启动，否则可能看不到常驻卡片或后台停止更新。
- iOS/macOS：首次启动会请求蓝牙权限。
- 主要代码：
lib/main.dart（UI 与交互）、lib/heart_rate_manager.dart（扫描、连接、心率订阅与推送）。 - 依赖安装：
flutter pub get。 - 运行：
flutter run -d <device>。 - 测试：
flutter test。 - 打包：
flutter build apk|ios|windows|macos|linux。 - 代码风格：2 空格缩进；
dart format .；启用flutter_lints。
- Windows 平台下中文路径可能会存在运行失败的问题，建议在英文路径目录下执行本程序。
- Android：状态栏/导航栏颜色同步与沉浸式刷新优化（含部分定制 ROM 适配）。
- Android：常驻通知通道与样式升级，权限请求与颜色配置更稳定。
- Android：Play Core 适配 targetSdk 34（迁移至 feature-delivery），Release 构建签名更完整。
- 性能：心率 UI 刷新节流，降低无效重建提升流畅度。
- 工程：全平台包名统一为
moe.iacg.hrpush。
- OSC：新增 ChatBox 心率推送，支持
{hr}/{percent}模板与节流/去重，避免刷屏。 - UI：设置页新增 ChatBox 开关与模板输入；移除旧的 ChatBox 建议提示文案。
- 文档与仓库：README 结构重构；新增 MIT License；.gitignore 增加本地发布脚本忽略。
- UI：应用标题统一为“心率推送”（桌面窗口、应用标题、iOS 显示名、测试文案）。
- UI：主页/配置页布局调整，设置按钮与保存按钮样式统一。
- OSC：推送心率时强制同步在线状态，避免状态滞后。
- Android：常驻通知通道更新，避免旧通道冲突。
- CI：Release 流程移除未签名 iOS 打包步骤。
- Release：发布包命名统一为
hr-push前缀（macOS/Windows）。 - 文档：新增/更新 VRChat 与安卓截图、补充已测试设备清单与 Windows 中文路径已知问题说明。
- 资源：替换主界面/配置页/VRChat 截图。
- 开发：忽略
.vscode/settings.json，测试用例标题同步新名称。
- Windows：最小化到托盘后支持点击托盘图标恢复窗口。
- Windows：掉线后自动重连更稳定（扫描卡死自愈、广播心率候选识别增强、陈旧连接句柄清理）。
- UI：减少无关重建，整体交互更流畅。
- OSC：
/avatar/parameters/hr_connected更贴合实际在线状态（抗抖动与掉线恢复）。
- 新增 MQTT 推送（Broker 填写即启用，端口/Topic/鉴权可配）。
- Android 新增通知栏常驻心率卡片，并自动按刷新间隔更新。
- RSSI 轮询刷新间隔与配置一致，连接后持续刷新信号。
- 自动重连逻辑与按钮状态修复，避免重连死锁和重复连接。
- Windows：BLEServer 在中文用户名/路径下运行更稳定（Public ASCII 临时目录 + 正确工作目录）。
- Windows：最小化自动隐藏到系统托盘，悬停显示在线状态与心率摘要。
- Android：发布构建启用 R8 混淆、资源压缩与 ABI 分包；Windows/macOS/iOS 开启链接优化以减小体积。
- Windows：BLE 连接在数据长时间未更新时会主动重连，提升掉线恢复成功率。
- Windows/macOS/Android/iOS 统一使用
images/logo.png生成应用图标。 - Windows：最小化/失焦时暂停心跳动画，降低 GPU 占用；检测心率数据长时间未更新时主动重连。
- README 补充中文路径构建提示。
- 依赖配置同步：
flutter_launcher_icons扩展桌面平台支持。
本项目采用 MIT License，详见 LICENSE。
- English: README_EN.md
- 日本語: README_JA.md
欢迎提交 Issue / PR，一起完善 BLE 兼容性与推送链路。若在特定设备或平台遇到问题，请附上日志与环境信息，便于复现。
