Android-BLE蓝牙框架快速入门与实战指南

最新推荐文章于 2025-04-11 10:57:24 发布

戴艺音

最新推荐文章于 2025-04-11 10:57:24 发布

阅读量558

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00074/article/details/138148946

AmovLab的Some项目是一个基于ES6的多用途框架，提供模块化、高效数据处理、HTTP客户端和任务调度器等功能，适用于Web开发、Node.js应用和脚本自动化，易用且高度可扩展，是开发者提升开发体验的理想选择。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Android-BLE蓝牙框架快速入门与实战指南

Android-BLE Android-BLE蓝牙框架,提供了扫描、连接、使能/除能通知、发送/读取数据、接收数据,读取rssi,设置mtu等蓝牙相关的所有操作接口,内部优化了连接队列,以及快速写入队列, 并支持多服务通讯,可扩展配置蓝牙相关操作。项目地址: https://gitcode.com/gh_mirrors/an/Android-BLE

项目介绍

Android-BLE是一款专为Android平台设计的蓝牙低功耗（BLE）框架，支持从Android 4.3（API级别18）开始的所有版本。此框架提供了全面的蓝牙操作接口，包括但不限于设备扫描、建立连接、启用/禁用通知、数据的发送与接收、RSSI读取以及MTU设置等。框架内部实现了连接队列的优化和高速写入机制，同时支持多服务通信，并允许用户自定义配置蓝牙操作。通过这个框架，开发者能够轻松地集成BLE功能进入应用程序，简化蓝牙设备的交互流程。

项目快速启动

添加依赖

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

dependencies {
    implementation 'com.github.aicareles:Android-BLE:3.3.1'
}

// 确保项目根目录下的build.gradle包含JitPack仓库
allprojects {
    repositories {
        maven { url 'https://www.jitpack.io' }
    }
}

初始化框架

在你的Application类中初始化Android-BLE框架，确保配置符合你的需求：

private void initBle() {
    Ble.options()
       .setLogBleEnable(true) // 开启调试日志
       .setThrowBleException(true) // 抛出蓝牙异常
       .setMaxConnectNum(7) // 设置最大连接数
       .setScanPeriod(12000) // 扫描周期
       .setUuidService(UUID.fromString(UuidUtils.uuid16To128("Your_Service_UUID")))
       // 根据实际设备配置其余UUID
       .create(this, new Ble.InitCallback() {
           @Override
           public void success() {
               BleLog.e("初始化成功");
           }

           @Override
           public void failed(int failedCode) {
               BleLog.e("初始化失败: " + failedCode);
           }
       });
}

扫描设备

示例代码展示如何开始扫描附近的BLE设备：

Ble.startScan(new BleScanCallback<BleDevice>() {
    @Override
    public void onLeScan(BleDevice device, int rssi, byte[] scanRecord) {
        // 处理发现的设备
    }
});

连接设备

一旦找到目标设备，你可以这样发起连接：

BleDevice targetDevice = ...; // 设备实例
Ble.connect(targetDevice, new BleConnCallback<BleDevice>() {
    @Override
    public void onConnectSuccess(BleDevice device) {
        // 连接成功后的处理
    }
});

应用案例和最佳实践

数据交换

发送数据: 使用write方法向设备发送数据。

byte[] data = ...; // 准备的数据
Ble.write(yourDevice, data, new BleWriteCallback<>() { /* 回调处理 */ });

接收数据: 实现相应的回调来处理收到的数据。

Ble.enableNotify(device, true, new BleNotifyCallback<>(){ 
    @Override
    public void onChanged(BleDevice device, BluetoothGattCharacteristic characteristic) {
        byte[] dataReceived = characteristic.getValue();
        // 处理接收到的数据
    }
});