❤️ 心率监控器 - HeartRateMonitor

一个专为实时显示心率而设计的轻量级桌面应用，支持悬浮窗显示，适用于游戏等全屏活动。现在还支持通过 API 提供心率数据，配合 Xbox Game Bar 小组件使用，即使在独占全屏游戏中也能查看心率！

📱 本项目的 Android 版本现已发布：点击查看 → HeartRateMonitorMobile

---

✨ 功能亮点

• 📡 低功耗蓝牙 (BLE) 扫描：查找并连接支持心率广播的设备（如小米手环等）。
• 🖥️ 可自定义悬浮窗：在桌面上实时显示心率，支持字体颜色自定义与拖拽定位。
• 🔒 可穿透点击：锁定悬浮窗后支持点击穿透，不干扰操作。
• 🌐 API服务器支持：允许其他程序通过本地 API 获取心率数据。
• 🕹️ VRChat OSC支持: 支持在vrchat聊天框显示心率。
• 🔗 Webhook 数据推送: 支持将心率数据主动推送到多个自定义URL，可自由配置请求的URL、Header和Body，并支持一键同步官方预设。
• 🎮 可选 Xbox Game Bar 小组件：解决独占全屏游戏无法显示悬浮窗的问题。

---

🚀 安装与使用

✅ 方法一：下载可执行文件

1. 前往 Releases 页面 下载最新版本的可执行文件（.exe）。
2. 将文件放进单独的文件夹并双击运行 HeartRateMonitor.exe，无需安装 Python 环境。

---

🔧 方法二：从源码运行

1. 克隆仓库：

   git clone https://github.com/ccc007ccc/HeartRateMonitor
   cd HeartRateMonitor

2. 安装依赖：

   pip install -r requirements.txt

3. 运行主程序：

   python main.py

---

📌 使用步骤（主程序）

1. 启动程序后，点击 “扫描设备”，选择您的心率设备并连接。
2. 点击 “显示悬浮窗” 开启心率悬浮窗，可自由拖动位置。
3. 点击 “锁定悬浮窗” 开启穿透点击功能（颜色将变化）。
4. 点击 “保存设置” 持久保存设备和窗口配置，程序退出时也会自动保存。

---

🎮 可选：Xbox Game Bar 小组件（安装复杂）

⚠️ 仅在独占全屏游戏中需要使用此组件！ 对于无边框或窗口化模式，主程序自带悬浮窗已经足够！

HeartRateWidget 是一款 Game Bar 小组件，配合主程序的 API 服务工作，可实现心率在游戏中叠加显示。

🧩 安装小组件

1. 下载 最新的HeartRateWidget压缩包
2. 解压 HeartRateWidget.zip。
3. 右键点击 Install.ps1 → 选择 “使用 PowerShell 运行”。

4. 按提示启用 开发者模式 并完成安装。

---

📺 启动与使用小组件

1. 按 Win + G 打开 Xbox Game Bar。
2. 在小组件菜单中找到 HeartRateWidget 并点击。
3. 初次显示为 ❤️N/A，点击右上角图钉将其固定在屏幕上。

---

🔓 允许小组件访问 API（仅首次设置）

1. 下载并运行 EnableLoopback 工具。
2. 勾选列表中的 HeartRateWidget 应用 → 点击 “Save Changes”。

---

🌐 启用主程序的 API 服务器

1. 打开 HeartRateMonitor 主程序。
2. 勾选 “启用API服务器”。
3. HeartRateWidget 将自动连接并显示您的实时心率。

❓常见问题

Q1: 为什么悬浮窗在某些游戏里不显示？ A: 游戏使用了“独占全屏”模式，请改为“窗口化”或使用 Xbox Game Bar 小组件。

Q2: 无法找到心率设备？ A: 请确保设备开启了心率广播，且电脑蓝牙功能正常。