# LightBLE

**Repository Path**: yunlong_cn/smart-ble

## Basic Information

- **Project Name**: LightBLE
- **Description**: 一个功能比较全面的蓝牙调试工具。支持所有使用蓝牙4.0低功耗的设备接入调试，提供蓝牙设备搜索、读取服务、浏览特征等操作。
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: AI
- **Homepage**: https://i2kai.com
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 35
- **Created**: 2025-03-14
- **Last Updated**: 2025-03-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LightBLE 蓝牙调试工具

<div align="center">
  <h3>多平台BLE调试工具，支持微信小程序、iOS和Android原生应用</h3>
  <p>
    <a href="https://lightble.i2kai.com/">官方网站</a> ·
    <a href="#快速开始">快速开始</a> ·
    <a href="#应用截图">应用截图</a> ·
    <a href="#主要功能">功能介绍</a>
  </p>
  <p>
    <img src="https://img.shields.io/badge/版本-1.0.0-blue.svg" alt="版本" />
    <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="协议" />
    <img src="https://img.shields.io/badge/platform-iOS%20%7C%20Android%20%7C%20小程序-lightgrey.svg" alt="平台" />
  </p>
</div>

<div align="center">
  <img src="https://lightble.i2kai.com/qr_code.jpg" alt="微信小程序码" width="200" />
  <p>扫码使用微信小程序版本</p>
</div>

## 🌐 相关链接

- **官方网站**：[https://lightble.i2kai.com](https://lightble.i2kai.com)
- **问题反馈**：[Issues](https://github.com/your-username/smart-ble/issues)
- **开发文档**：[Documentation](https://lightble.i2kai.com/docs)
- **更新日志**：[Changelog](#版本记录)

## 💡 项目简介

LightBLE 是一款专业的蓝牙调试工具，基于 uni-app + Vue 3 开发，支持多平台部署。

- 版本：1.0.0
- 框架：uni-app + Vue 3
- 开源协议：MIT

## 📱 应用截图

<div align="center">
  <div>
    <img src="./doc/images/默认页.jpg" alt="默认界面" width="200" style="margin: 5px;" />
    <img src="./doc/images/搜索设备.jpg" alt="搜索设备" width="200" style="margin: 5px;" />
    <img src="./doc/images/广播页.jpg" alt="广播页" width="200" style="margin: 5px;" />
  </div>
  <div style="margin-top: 10px;">
    <img src="./doc/images/连接详情1.jpg" alt="设备详情" width="200" style="margin: 5px;" />
    <img src="./doc/images/连接详情2.jpg" alt="服务列表" width="200" style="margin: 5px;" />
    <img src="./doc/images/连接详情3.jpg" alt="特征值操作" width="200" style="margin: 5px;" />
  </div>
</div>

## ✨ 主要功能

### 🌐 多平台支持
- 完整支持微信小程序、iOS和Android原生应用
- 提供统一的API接口，轻松实现跨平台开发
- 内置权限管理，自动处理蓝牙和定位权限请求

### 🛠️ 核心功能
- 🔍 蓝牙设备扫描与发现
- 📱 设备详情查看
- 📡 自定义蓝牙广播
- 📊 广播数据和扫描响应配置
- ⚙️ 灵活的参数配置
- ⚡ 实时数据监控

## 📋 版本记录

### v1.0.0 (2024-03-14)
- 🎉 首次发布
- ✨ 支持蓝牙设备扫描与发现
- 🔄 支持自定义蓝牙广播
- 📊 支持数据可视化展示
- 🛠️ 支持多平台部署

### v0.9.0 (2024-03-01)
- 🧪 内测版本发布
- 🔧 修复已知问题
- 📱 优化用户界面

### v0.8.0 (2024-02-15)
- 💫 Beta 版本发布
- 🎨 界面改版优化
- 🔍 新增搜索功能

## 👨‍💻 开发者其他应用

<div align="center">
  <table>
    <tr>
      <td align="center">
        <img src="https://lightble.i2kai.com/apps/app1_qr.jpg" width="100" alt="应用1二维码"/><br/>
        <b>智能家居助手</b><br/>
        <small>智能家居设备管理工具</small>
      </td>
      <td align="center">
        <img src="https://lightble.i2kai.com/apps/app2_qr.jpg" width="100" alt="应用2二维码"/><br/>
        <b>WiFi调试大师</b><br/>
        <small>专业的WiFi网络分析工具</small>
      </td>
      <td align="center">
        <img src="https://lightble.i2kai.com/apps/app3_qr.jpg" width="100" alt="应用3二维码"/><br/>
        <b>串口调试助手</b><br/>
        <small>多功能串口通信工具</small>
      </td>
    </tr>
  </table>
</div>

## 🔧 技术实现

### 技术栈
- 前端框架：Vue 3
- UI 框架：@dcloudio/uni-ui
- 原生插件：BLE-Module（自定义蓝牙广播插件）

### 平台支持
- **微信小程序**：使用微信小程序原生API
- **iOS原生**：基于CoreBluetooth框架
- **Android原生**：支持Android 5.0及以上版本

## 📦 项目结构

```
smart-ble/
├── SmartBLE/              # 主项目目录
│   ├── pages/            # 页面文件
│   │   ├── index/       # 主页（设备列表）
│   │   ├── device/      # 设备详情页
│   │   └── broadcast/   # 广播配置页
│   ├── static/          # 静态资源
│   ├── utils/          # 工具函数
│   ├── nativeplugins/  # 原生插件
│   └── App.vue         # 应用入口
└── docs/               # 文档和资源
```

## 🚀 快速开始

### 安装
```bash
cd SmartBLE
npm install
```

### 运行
```bash
# H5版本
npm run dev:h5

# 微信小程序
npm run dev:mp-weixin

# App开发
npm run dev:app
```

### 使用示例
```javascript
// 初始化蓝牙模块
uni.openBluetoothAdapter({
  success: () => {
    console.log('蓝牙初始化成功');
    // 开始搜索设备
    uni.startBluetoothDevicesDiscovery({
      success: () => {
        console.log('开始搜索设备');
      }
    });
  }
});

// 监听设备发现事件
uni.onBluetoothDeviceFound((devices) => {
  console.log('发现新设备:', devices);
});

// 连接设备
function connectDevice(deviceId) {
  uni.createBLEConnection({
    deviceId: deviceId,
    success: () => {
      console.log('连接成功');
      // 获取设备服务
      uni.getBLEDeviceServices({
        deviceId: deviceId,
        success: (res) => {
          console.log('设备服务列表:', res.services);
        }
      });
    }
  });
}
```

## 📝 权限说明

### Android 权限
- 蓝牙权限（BLUETOOTH）
- 蓝牙管理权限（BLUETOOTH_ADMIN）
- 位置权限（ACCESS_FINE_LOCATION）
- 蓝牙扫描权限（BLUETOOTH_SCAN）
- 蓝牙广播权限（BLUETOOTH_ADVERTISE）
- 蓝牙连接权限（BLUETOOTH_CONNECT）

### iOS 权限
- 蓝牙权限（用于搜索和连接蓝牙设备）

## ⚠️ 注意事项

1. Android 设备需要定位权限才能搜索蓝牙设备
2. iOS 需要在 Info.plist 中配置蓝牙权限描述
3. 微信小程序需要在开发者后台配置蓝牙相关权限

## 📥 下载安装

- [iOS App Store](#)
- [Google Play](#)
- 微信小程序：扫描顶部二维码

## 🤝 贡献指南

欢迎提交问题和改进建议！我们欢迎任何形式的贡献：
- 🐛 报告问题
- 💡 提交功能建议
- 🔧 提交代码改进
- 📖 完善文档

## 📄 开源协议

本项目采用 [MIT License](LICENSE) 开源协议