Android蓝牙功能开发（低功耗与经典）

人民的石头

已于 2024-02-27 14:31:53 修改

阅读量1.5k

点赞数 23

分类专栏：移动端 Android 文章标签： android

于 2023-12-12 13:07:16 首次发布

本文链接：https://blog.csdn.net/shi450561200/article/details/134946630

版权

Android 同时被 2 个专栏收录

54 篇文章 1 订阅

订阅专栏

移动端

22 篇文章 1 订阅

订阅专栏

一、第一种框架集成方式

1.在项目根目录的build.gradle文件中，添加如下配置：

2.在app module的build.gradle中，添加依赖：

3.使用前先在你应用的Application中调init方法初始化框架

4.然后必须调用enableBluetooth()方法开启蓝牙功能，你可以在activity中调用：

5.如果是低功耗蓝牙，需要设置配置项，经典蓝牙忽略跳过这一步即可：

6.开启蓝牙能力后，接着你就可以开始进行蓝牙设备扫描，其中，type 为蓝牙设备类型（经典蓝牙或低功耗蓝牙）：

7.一旦扫描到设备，你就可以找到目标设备并连接：

8.设备连接成功后，你可以开始跟设备进行通信：

9.那么如何接收蓝牙设备返回给你的数据呢，很简单，在Receiver中接收：

10.最后，调用以下方法去主动断开连接并释放资源：

第二种集成方式

1.由于是代码引入，故无需像第一步那样进行库的引入，直接在Application中初始化。

2.蓝牙界面

3.UUidStateBean对象

4.蓝牙信息对象BletoothInfoBen

5.进度对话框

6.ble_servies_select_dialog布局

7.gble_layout蓝牙布局

Android 蓝牙开发，很多项目会使用到，自己去摸索封装或者引用其他框架，也能解决部分问题。为何说是部分问题，Android蓝牙分为低功耗版与经典版，经典版是可以直接选择即可实现链接，低功耗版是需要配置uuid。故推荐一个框架，下面来分享使用教程。分两部分第一部分是直接使用框架，第二部分是修改框架源码，使用哪一种方式可以结合自己的需要。Android开发建议使用Android蓝牙调试工具app初步调试使用，这里推荐BLE调试助手app，各大应用市场都可以下载。BLE调试助手首页展示。

Java语言版本地址：https://github.com/g-HJY/HBluetooth
Kotlin语言版本地址：https://github.com/g-HJY/Kotlin-HBluetooth （暂停维护）

一、第一种框架集成方式

首先是集成方式，当然你可以直接在github上将整个项目下载下来，也可以将其以依赖的形式集成到你的项目中，具体步骤如下：

1.在项目根目录的build.gradle文件中，添加如下配置：

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

2.在app module的build.gradle中，添加依赖：

dependencies {
     implementation 'com.github.g-HJY:HBluetooth:V1.3.6'
}

3.使用前先在你应用的Application中调init方法初始化框架

public class XiaoYaApp extends MultiDexApplication {

    @Override
    public void onCreate() {
        super.onCreate();
        HBluetooth.init(this);
    }

}

4.然后必须调用enableBluetooth()方法开启蓝牙功能，你可以在activity中调用：

//开启蓝牙功能
HBluetooth.getInstance().enableBluetooth()

5.如果是低功耗蓝牙，需要设置配置项，经典蓝牙忽略跳过这一步即可：

分别是主服务UUID（withServiceUUID）、读写特征值UUID（withWriteCharacteristicUUID）、通知UUID（withNotifyCharacteristicUUID）以及是否设置最大传输单元（setMtu不设置不用调）等；您还可以设置分包发送的时间间隔和包长度

     //请填写你自己设备的UUID
        //低功耗蓝牙才需要如下配置BleConfig,经典蓝牙不需要new HBluetooth.BleConfig()
        HBluetooth.BleConfig bleConfig = new HBluetooth.BleConfig();
        bleConfig.withServiceUUID("0000fe61-0000-1000-8000-00805f9b34fb")
                 .withWriteCharacteristicUUID("0000fe61-0000-1000-8000-00805f9b34fb")
                 .withNotifyCharacteristicUUID("0000fe61-0000-1000-8000-00805f9b34fb")
                //命令长度大于20个字节时是否分包发送，默认false,分包时可以调两参方法设置包之间发送间隔
                //.splitPacketToSendWhenCmdLenBeyond(false)
                //useCharacteristicDescriptor 默认false
                //.useCharacteristicDescriptor(false)
                .setMtu(200, new BleMtuChangedCallback() {
                    @Override
                    public void onSetMTUFailure(int realMtuSize, BluetoothException bleException) {
                        Log.i(TAG, "bleException:" + bleException.getMessage() + "  realMtuSize:" + realMtuSize);
                    }
 
                    @Override
                    public void onMtuChanged(int mtuSize) {
                        Log.i(TAG, "Mtu set success,mtuSize:" + mtuSize);
                    }
                });
     //低功耗蓝牙才需要调setBleConfig
	HBluetooth.getInstance().setBleConfig(bleConfig);

6.开启蓝牙能力后，接着你就可以开始进行蓝牙设备扫描，其中，type 为蓝牙设备类型（经典蓝牙或低功耗蓝牙）：

           HBluetooth.getInstance()
                .scan(type, new ScanCallBack() {
            @Override
            public void onScanStart() {
                Log.i(TAG, "开始扫描");
            }
 
            @Override
            public void onScanning() {
                Log.i(TAG, "扫描中");
            }
 
            @Override
            public void onError(int errorType, String errorMsg) {
 
            }
 
            @Override
            public void onScanFinished(List<BluetoothDevice> bluetoothDevices) {
                Log.i(TAG, "扫描结束");
                if (bluetoothDevices != null && bluetoothDevices.size() > 0) {
                    list.clear();
                    list.addAll(bluetoothDevices);
                    adapter.notifyDataSetChanged();
                }
            }
        });
 
 
或者，如果你想在第一步操作后直接进行扫描，则可以这样调用：
        HBluetooth.getInstance()
                .enableBluetooth()
                .scan(type, new ScanCallBack() {
            @Override
            public void onScanStart() {
                Log.i(TAG, "开始扫描");
            }
 
            @Override
            public void onScanning() {
                Log.i(TAG, "扫描中");
            }
 
            @Override
            public void onError(int errorType, String errorMsg) {
 
            }
 
            @Override
            public void onScanFinished(List<BluetoothDevice> bluetoothDevices) {
                Log.i(TAG, "扫描结束");
                if (bluetoothDevices != null && bluetoothDevices.size() > 0) {
                    list.clear();
                    list.addAll(bluetoothDevices);
                    adapter.notifyDataSetChanged();
                }
            }
        });

7.一旦扫描到设备，你就可以找到目标设备并连接：

         HBluetooth.getInstance()
           .connect(device, new ConnectCallBack() {
 
                       @Override
                       public void onConnecting() {
                           Log.i(TAG, "连接中...");
                       }
 
                       @Override
                       public void onConnected(Sender sender) {
                           Log.i(TAG, "连接成功,isConnected:" + mHBluetooth.isConnected());
                           //调用发送器发送命令
                           byte[] demoCommand = new byte[]{0x01, 0x02};
                           sender.send(demoCommand, new SendCallBack() {
                               @Override
                               public void onSending(byte[] command) {
                                   Log.i(TAG, "命令发送中...");
                               }
 
                               @Override
                               public void onSendFailure(BluetoothException bleException) {
                                   Log.e("mylog", "发送命令失败->" + bleException.getMessage());
                               }
                           });
                       }
 
                       @Override
                       public void onDisConnecting() {
                           Log.i(TAG, "断开连接中...");
                       }
 
                       @Override
                       public void onDisConnected() {
                           Log.i(TAG, "已断开连接,isConnected:" + mHBluetooth.isConnected());
                       }
 
                       @Override
                       public void onError(int errorType, String errorMsg) {
                           Log.i(TAG, "错误类型：" + errorType + " 错误原因：" + errorMsg);
                       }
 
                       //低功耗蓝牙才需要BleNotifyCallBack
                       //经典蓝牙可以只调两参方法connect(BluetoothDevice device, ConnectCallBack connectCallBack)
                   }, new BleNotifyCallBack() {
                       @Override
                       public void onNotifySuccess() {
                           Log.i(TAG, "打开通知成功");
                       }
 
                       @Override
                       public void onNotifyFailure(BluetoothException bleException) {
                           Log.i(TAG, "打开通知失败：" + bleException.getMessage());
                       }
                   });

8.设备连接成功后，你可以开始跟设备进行通信：

           HBluetooth.getInstance()
                     .send(demoCommand, new SendCallBack() {
                      @Override
                      public void onSending(byte[] command) {
                             Log.i(TAG, "命令发送中...");
                      }
 
                      @Override
                      public void onSendFailure(BluetoothException bleException) {
                             Log.e("mylog", "发送命令失败->" + bleException.getMessage());
                      }
                      });

9.那么如何接收蓝牙设备返回给你的数据呢，很简单，在Receiver中接收：

          public void initListener() {
              HBluetooth.getInstance().setReceiver(new ReceiveCallBack() {
                  @Override
                  public void onReceived(DataInputStream dataInputStream, byte[] result) {
                      // 打开通知后，设备发过来的数据将在这里出现
                      Log.e("mylog", "收到蓝牙设备返回数据->" + Tools.bytesToHexString(result));
                  }
              });
          }

10.最后，调用以下方法去主动断开连接并释放资源：

            HBluetooth.getInstance().release();

其他APi

1.带设备名称过滤条件的扫描：

public void scan(@BluetoothType int scanType, int timeUse, ScanFilter filter, ScanCallBack scanCallBack);

public void scan(@BluetoothType int scanType, ScanFilter filter, ScanCallBack scanCallBack);

2.设置连接超时:

HBluetooth.getInstance().setConnectTimeOut(5000);

3.BleConfig(BLE)设置分包发送时间间隔(默认20ms)及包长度(默认20个字节)：

public BleConfig splitPacketToSendWhenCmdLenBeyond(boolean splitPacketToSendWhenCmdLenBeyond, int sendTimeInterval);

public BleConfig splitPacketToSendWhenCmdLenBeyond(boolean splitPacketToSendWhenCmdLenBeyond, int sendTimeInterval, int eachSplitPacketLen);

4.开启断开后自动重连机制，默认关闭重连：

HBluetooth.getInstance().openReconnect(3, 4000);