EasyBle 使用教程

EasyBle 使用教程

EasyBle Android BLE framework 项目地址: https://gitcode.com/gh_mirrors/ea/EasyBle

1. 项目介绍

EasyBle 是一个针对 Android 平台的 BLE（蓝牙低功耗）操作框架，它简化了 Android 设备上的 BLE 操作，支持基本的 BLE 功能。该框架使得 BLE 设备的发现、连接、数据读写等操作变得更加简单和方便。特别适用于需要在 Android 设备上进行 BLE 通信的开发者。

2. 项目快速启动

2.1 添加依赖

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

allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}

dependencies {
    implementation 'com.github.Ficat:EasyBle:v3.0.1'
}

2.2 初始化

在 Application 类中初始化 EasyBle：

BleManager bleManager = BleManager.getInstance()
    .setScanOptions(BleManager.ScanOptions.newInstance().scanPeriod(10000).scanDeviceName(null))
    .setConnectionOptions(BleManager.ConnectionOptions.newInstance().connectTimeout(12000))
    .setLog(true, "TAG")
    .init(this.getApplication());

2.3 BLE 权限

确保在 Android 12 或更高版本的设备上请求必要的 BLE 权限：

List<String> permissions = BleManager.getBleRequiredPermissions();
if (permissions.size() > 0) {
    // 请求权限
    requestPermissions(permissions);
}

2.4 扫描设备

启动扫描以发现 BLE 设备：

bleManager.startScan(new BleScanCallback() {
    @Override
    public void onLeScan(BleDevice device, int rssi, byte[] scanRecord) {
        // 处理扫描到的设备
        String name = device.getName();
        String address = device.getAddress();
    }

    @Override
    public void onStart(boolean startScanSuccess, String info) {
        // 处理扫描开始结果
    }

    @Override
    public void onFinish() {
        // 处理扫描结束
    }
});

2.5 连接设备

连接到目标 BLE 设备：

bleManager.connect(bleDevice, new BleConnectCallback() {
    @Override
    public void onStart(boolean startSuccess, String info, BleDevice device) {
        // 处理连接开始结果
    }

    @Override
    public void onFailure(int failureCode, String info, BleDevice device) {
        // 处理连接失败
    }

    @Override
    public void onConnected(BleDevice device) {
        // 处理连接成功
    }

    @Override
    public void onDisconnected(String info, int status, BleDevice device) {
        // 处理断开连接
    }
});

3. 应用案例和最佳实践

在这一部分，您可以提供一些使用 EasyBle 实现的具体应用案例，比如智能家居设备控制、健康监测设备同步等，以及这些场景下的最佳实践。

4. 典型生态项目

在这一部分，您可以列出一些使用 EasyBle 的典型生态项目，这些项目可以是社区成员贡献的，也可以是官方推荐的优秀项目，以示例的形式展示 EasyBle 的应用范围和潜力。

EasyBle Android BLE framework 项目地址: https://gitcode.com/gh_mirrors/ea/EasyBle