H-Ble
Introduction: Android Ble 类库,基于回调,暴露搜索、连接、发送、接收、断开连接等接口,无需关心细节操作即可进行 Ble 通信。
Tags:
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 加入其中自动匹配。所以有此需求可以使用其他支持的库。
- 注意:蓝牙的使用,与设备有莫大的关联,所以适配方面需要多加处理 此库在 ZUK Z2 6.0/7.0,魅蓝 note3 5.1,红米 note3 5.0,一加 7.0,华为 7.0 等手机上测试无问题,其他机型请自测
