mi-scale-exporter 项目技术文档
1. 安装指南
1.1 下载与安装
mi-scale-exporter 是一个移动应用程序,用于从小米体脂秤(Mi Body Composition Scale)导出数据并上传至 Garmin Connect Cloud。您可以通过以下方式下载并安装该应用:
- Google Play 商店:访问 Google Play 商店 下载并安装应用。
- APK/AAB 安装包:从 GitHub 发布页面 下载 APK 或 AAB 文件,手动安装到您的 Android 设备上。
1.2 系统要求
- 支持 Android 10 及以上版本。
- 设备需支持蓝牙连接。
2. 项目使用说明
2.1 初始设置
- 连接体脂秤:打开应用后,首先需要连接您的小米体脂秤。确保体脂秤已开启,并站在秤上进行测量。
- 填写用户数据:在应用中填写您的个人信息,包括身高、体重、年龄等。
- 获取蓝牙地址:在 Zepp Life 应用中找到您的体脂秤蓝牙地址,并将其复制到 mi-scale-exporter 应用中。
2.2 数据测量与上传
- 测量数据:站在体脂秤上进行测量,应用会自动获取您的体重和阻抗数据。
- 计算体成分:应用会根据获取的数据计算您的体成分,包括脂肪百分比、肌肉质量等。
- 上传至 Garmin Cloud:您可以选择将数据直接上传至 Garmin Connect Cloud,或通过代理 API 服务器上传。
2.3 手动数据输入
如果您没有小米体脂秤,也可以手动输入体成分数据,并将其上传至 Garmin Cloud。
3. 项目 API 使用文档
3.1 API 端点
mi-scale-exporter 应用支持通过代理 API 服务器上传数据。默认的 API 端点为:
https://frog01-20364.wykr.es
3.2 API 功能
- 上传体成分数据:通过
/upload
端点上传体成分数据。 - 上传血压数据:通过
/uploadbloodpressure
端点上传血压数据。
3.3 自托管 API 服务器
如果您担心数据安全,可以选择自托管 API 服务器。只需在应用设置中更改服务器地址即可。
4. 项目安装方式
4.1 通过 Google Play 商店安装
- 打开 Google Play 商店。
- 搜索 "MiScale Exporter"。
- 点击安装按钮,等待应用下载并安装完成。
4.2 通过 APK/AAB 文件安装
- 从 GitHub 发布页面 下载 APK 或 AAB 文件。
- 将文件传输到您的 Android 设备。
- 在设备上找到文件并点击安装。
4.3 自托管 API 服务器
- 克隆 yet-another-garmin-connect-client 项目。
- 按照项目文档部署 API 服务器。
- 在 mi-scale-exporter 应用中设置自托管服务器的地址。
通过以上步骤,您可以顺利安装并使用 mi-scale-exporter 应用,将体脂秤数据上传至 Garmin Connect Cloud。