❤️ 心率监控器 - HeartRateMonitor

一款基于 BLE（蓝牙低功耗）技术的 Android 心率监测应用，支持主界面与悬浮窗双视图展示实时心率，并提供丰富的个性化设置与数据接口。

🖥️ 想要在 Windows 桌面使用心率悬浮窗？点击跳转桌面版 HeartRateMonitor

---

✨ 功能特性

• 🔵 蓝牙连接：扫描并连接支持心率服务的 BLE 设备。
• ⭐ 设备管理：快速收藏常用设备，支持启动时自动连接和意外断开后自动重连。
• ❤️ 心跳动画：根据心率跳动频率动态变化。
• 📊 心率历史与图表分析:
  • 自动记录：可选的后台记录功能，自动为每一次连接（从连接到断开）保存为一段心率历史会话。
  • 历史列表：清晰展示所有历史记录，包括设备名称、记录起止时间。
  • 批量管理：通过长按进入多选模式，支持对历史记录进行全选和批量删除。
  • 深度图表分析：点击任意历史记录，可查看该时段完整的心率变化图表。支持缩放、拖动，并通过触摸在图表上精确查看任意时间点的心率值。
  • 横屏查看：在图表详情页提供一键横屏功能，以获得更好的数据概览体验。
• 🎨 高度自定义设置：
  • 功能开关：可自由开启或关闭心率记录、心跳动画、自动连接等功能，并为耗电功能提供友好提醒。
  • 悬浮窗样式：可完全自定义悬浮窗的元素（BPM文本/图标）、颜色（文字/背景/边框）、透明度、圆角、整体大小与图标尺寸。
• 📡 强大的数据接口 (Webhook & Server)：
  • HTTP 服务器：内置HTTP服务器，可供其他应用或设备通过局域网被动拉取实时心率数据。
  • WebSocket 服务器: 内置WebSocket服务器，可向所有连接的客户端实时主动推送心率和连接状态。
  • Webhook 推送：完善的Webhook系统，可在“连接成功”、“连接断开”、“心率更新”等多种事件触发时，将数据主动推送到多个自定义URL，并支持{bpm}占位符。
  • 预设管理：可以自由新增、编辑、删除、测试和启用/禁用多个Webhook预设，并支持从GitHub一键同步官方预设。

---

📦 安装与运行

1. 克隆项目

   git clone [https://github.com/ccc007ccc/HeartRateMonitorMobile.git](https://github.com/ccc007ccc/HeartRateMonitorMobile.git)

2. 打开项目

   • 使用 Android Studio 打开项目文件夹。
   • 等待 Gradle 自动同步依赖。

3. 构建并运行

   • 使用真机或模拟器（建议 API ≥ 27）连接。
   • 点击工具栏中的 ▶️ 运行按钮，即可编译并启动应用。

---

🧭 使用指南

1. 首次权限授予

   • 启动时请允许所需的 蓝牙权限 与 定位权限。

2. 开启心率记录 (可选)

   • 进入 设置 页面，找到“功能设置”下的“心率记录功能”开关。
   • 点击开启，App将在您连接设备后自动保存心率数据。此功能默认关闭以节省电量。

3. 连接心率设备

   • 点击主页右下角的“扫描”按钮，在设备列表中选择您的设备进行连接。
   • 连接成功后，您将在主页看到实时心率数值和动态图表。

4. 查看历史记录

   • 在主页点击“查看心率历史记录”卡片，即可进入历史列表。
   • 长按 任意记录可进入多选模式进行批量删除。
   • 单击 任意记录可查看详细的心率图表。

5. 使用悬浮窗

   • 点击主页顶部的悬浮窗图标按钮可开启/关闭悬浮窗。
   • 在 设置 -> 悬浮窗设置 中可自定义其外观。

6. 配置数据接口 (高级)

   • 在 设置 -> 数据与服务 中，可以找到 服务器设置 和 Webhook 设置 的入口。

---

🖼️ 截图展示

(建议您在完成功能后，替换为包含新功能界面的最新截图)