【亲测免费】 Android-BLE 蓝牙框架使用教程

1. 项目介绍

Android-BLE 是一个功能丰富的蓝牙框架，为Android应用开发提供了扫描、连接、通知使能/除能、发送/读取数据等蓝牙操作接口。该框架内部优化了连接队列和快速写入队列，支持多服务通讯，并且可以扩展配置蓝牙相关操作。适用于需要蓝牙功能的项目，尤其是那些需要与多种蓝牙设备通信的应用。

2. 项目快速启动

2.1 添加依赖

首先，在项目的 build.gradle 文件中添加以下依赖：

implementation 'com.github.aicareles:Android-BLE:3.3.1'

确保在项目根目录的 build.gradle 文件中添加：

maven { url 'https://www.jitpack.io' }

2.2 权限适配

根据Android版本，添加相应的蓝牙权限：

List<String> permissions = new ArrayList<>();
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
    permissions.add(Manifest.permission.BLUETOOTH_SCAN);
    permissions.add(Manifest.permission.BLUETOOTH_ADVERTISE);
    permissions.add(Manifest.permission.BLUETOOTH_CONNECT);
} else {
    permissions.add(Manifest.permission.ACCESS_COARSE_LOCATION);
    permissions.add(Manifest.permission.ACCESS_FINE_LOCATION);
}
requestPermission(permissions);

2.3 初始化

在Application中初始化Android-BLE：

private void initBle() {
    Ble.options()
        .setLogBleEnable(true)
        .setThrowBleException(true)
        .setAutoConnect(false)
        .setIgnoreRepeat(false)
        .setConnectTimeout(10 * 1000)
        .setMaxConnectNum(7)
        .setScanPeriod(12 * 1000)
        .setScanFilter(scanFilter)
        .setUuidService(UUID.fromString(UuidUtils.uuid16To128("fd00")))
        .setUuidWriteCha(UUID.fromString(UuidUtils.uuid16To128("fd01")))
        .setUuidReadCha(UUID.fromString(UuidUtils.uuid16To128("fd02")))
        .setUuidNotifyCha(UUID.fromString(UuidUtils.uuid16To128("fd03")))
        .setUuidServicesExtra(new UUID[]{BATTERY_SERVICE_UUID})
        .setFactory(new BleFactory() {
            @Override
            public MyDevice create(String address, String name) {
                return new MyDevice(address, name);
            }
        })
        .setBleWrapperCallback(new MyBleWrapperCallback())
        .create(mApplication, new Ble.InitCallback() {
            @Override
            public void success() {
                BleLog.e("MainApplication", "初始化成功");
            }
            @Override
            public void failed(int failedCode) {
                BleLog.e("MainApplication", "初始化失败：" + failedCode);
            }
        });
}

2.4 开始使用

扫描设备

ble.startScan(scanCallback);

连接设备

ble.connect(device, connectCallback);

使能通知

ble.enableNotify(device, true, notifyCallback);

读取数据

ble.read(device, readCallback);

写入数据

ble.write(device, data, writeCallback);

断开连接

ble.disconnect(device);

释放资源

ble.released();

3. 应用案例和最佳实践

• 案例1： 实现一个简单的蓝牙温度计应用，使用Android-BLE框架扫描设备，连接温度计，读取温度数据。
• 最佳实践： 当处理多个设备时，利用框架的连接队列管理连接过程，避免因并发连接导致的问题。

4. 典型生态项目

• 项目1： 一个基于Android-BLE框架的智能家居控制系统，可以远程控制家中的蓝牙设备。
• 项目2： 一个医疗健康监测应用，通过蓝牙连接心电监测设备，实时获取心跳数据。