# android_ble_ecg

**Repository Path**: YIJia_Kitchen_Bath/android_ble_ecg

## Basic Information

- **Project Name**: android_ble_ecg
- **Description**: 用于ecg心电显示
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-17
- **Last Updated**: 2026-07-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Android BLE ECG Demo

这是一个基于 Android 的蓝牙低功耗 (BLE) 心电图 (ECG) 数据采集示例项目。项目支持实时数据接收、设备存储文件读取和文件列表获取。

![alt text](Screenshot_20260603-164555.png)

## 🚀 功能特性

- **设备连接管理**: 支持扫描、连接和管理 BLE 设备。
- **实时 ECG 数据接收**: 能够接收设备发送的实时心电数据。
- **文件数据读取**: 支持请求设备端存储的历史数据文件。
- **文件列表获取**: 可获取设备内存储的文件列表。
- **时间同步**: 支持向设备发送实时时间同步指令。
- **多语言示例**: 提供 Java 和 Kotlin 两种语言的实现示例。

## 📂 项目结构

- `core/`: 核心 BLE 库，封装了底层的蓝牙通信协议、连接管理及数据解析逻辑。
- `java-sample/`: 基于 Java 的应用示例，演示如何使用 `core` 库实现 BLE 数据接收功能。
- `kotlin-sample/`: 基于 Kotlin 的应用示例。
- `apk/`: 预编译的安装包。

## 🛠 技术栈

- **开发语言**: Java / Kotlin
- **最低 SDK**: API 19 (Android 4.4)
- **目标 SDK**: API 33
- **核心依赖**:
    - `AndroidX`: 基础组件库。
    - 自研 BLE 核心库 (`core` 模块)。

## 📦 安装与运行

1. **克隆项目**:
   ```bash
   git clone https://gitee.com/YIJia_Kitchen_Bath/android_ble_ecg.git
   ```
2. **导入 Android Studio**:
   打开 Android Studio，选择 `Open` 并选择项目根目录。
3. **同步 Gradle**:
   等待 Gradle 同步完成。
4. **运行项目**:
   选择 `java-sample` 或 `kotlin-sample` 模块，连接 Android 设备并运行。

## 📖 使用指南

1. **连接设备**: 在主页面扫描并连接目标 BLE 设备。
2. **接收实时数据**: 进入设备详情页，点击 "发送实时时间"，开启实时数据接收。
3. **查看文件列表**: 进入设备详情页，点击 "文件列表"，在列表中选择具体文件并请求设备端文件数据。

## ⚠️ 技术要点 (优化)

- **内存优化**: 已移除图形绘制相关数据累积逻辑，避免长时间接收实时数据时因缓存大量采样点导致内存压力。