Awesome Open Source
Awesome Open Source

H-Ble

Android Ble类库,基于回调,暴露搜索、连接、发送、接收、断开连接等接口,无需关心细节操作即可进行Ble通信。

API

具体使用请参考本项目提供的例子

获取BleController实例并进行初始化(初始化只需执行一次)

  • BleController.getInstance().init(this);

搜所设备,获取设备列表

  • BleController.getInstance().scanBle(int time,ScanCallback scanCallbak);

连接设备

  • BleController.getInstance().connect(int time,String deviceAdress,ConnectCallback connectCallback);

发送数据

  • BleController.getInstance().writeBuffer(byte[] buf,OnWriteCallback onWriteCallback);

注册接收数据的监听

  • BleController.getInstance().registReciveListener(String requestKey,OnReceiverCallback onReceiveCallback);

注销接收数据的监听

  • BleController.getInstance().unregistReciveListener(String requestKey);

断开连接

  • BleController.getInstance().closeBleConn();

必备操作

添加权限

<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

定位权限必须添加,否则Android 5.0以上的手机搜索不到设备

指定UUID

  • 打开BleController.class

  • 修改以下成员变量的值为自己所要通信的BLE模块对应的UUID

      private static final String BLUETOOTH_S = "0000fff0-0000-1000-8000-00805f9b34fb";
      private static final String BLUETOOTH_NOTIFY_C = "0000fff7-0000-1000-8000-00805f9b34fb";
      private static final String BLUETOOTH_WRITE_C = "0000fff6-0000-1000-8000-00805f9b34fb";
    

变量名最后一位字母:

S 代表service的UUID;

C 代表characteristic的UUID;

如果硬件没有提供UUID,可以下载Ble调试助手进行查看 http://download.csdn.net/detail/hansion3333/9753311


本库满足Android 4.3以上手机和BLE模块之间的连接与互发数据。

本库并未将常用Ble手表、心率计等设备的UUID加入其中自动匹配。所以有此需求可以使用其他支持的库。

个人博客:http://www.hansion.win

CSDN: http://blog.csdn.net/hansion3333

  • 注意:蓝牙的使用,与设备有莫大的关联,所以适配方面需要多加处理 此库在ZUK Z2 6.0/7.0,魅蓝note3 5.1,红米note3 5.0,一加7.0,华为7.0等手机上测试无问题,其他机型请自测

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
java (31,734
android (6,459
bluetooth (192
ble (101
bluetooth-low-energy (90