BluetoothLE-Multi-Library

2018/07/11 00:10
阅读数 64

github地址:https://github.com/qindachang/BluetoothLE-Multi-Library

BluetoothLE-Multi-Library

一个能够连接多台蓝牙设备的库,它可以作为client端,也可以为server端。支持主机/从机,外围设备连接。
在发送消息时,它内部支持队列控制,避免因蓝牙间隔出现操作失败的情况。

开始使用

1. 主机client

扫描

BluetoothLeScannerCompat scannerCompat = BluetoothLeScannerCompat.getScanner();
ScanSettings scanSettings = new ScanSettings.Builder() .setScanMode(ScanSettings.SCAN_MODE_LOW_LATENCY) .setReportDelay(int reportDelayMillis) //0 or above >0 .setUseHardwareBatchingIfSupported(false) .build(); //设置过滤扫描 List<ScanFilter> filters = new ArrayList<>(); ScanFilter builder = new ScanFilter.Builder().setDeviceName(deviceName).build(); filters.add(builder); ScanFilter builder = new ScanFilter.Builder().setDeviceAddress(deviceAddress).build(); filters.add(builder); ScanFilter builder = new ScanFilter.Builder() .setServiceUuid(ParcelUuid.fromString(serviceUUID.toString())).build(); filters.add(builder); scannerCompat.startScan(filters, scanSettings, scanCallback); 

扫描回调

private ScanCallback scanCallback = new ScanCallback() { @Override public void onScanResult(final int callbackType, final ScanResult result) { } @Override public void onBatchScanResults(final List<ScanResult> results) { } @Override public void onScanFailed(final int errorCode) { } };

连接

//创建连接的一个对象,后续将使用该对象来访问操作
private BluetoothLeConnector connector = BluetoothLe.newConnector(); private BluetoothGatt mBluetoothGatt; //配置连接对象 connector.setConfig(new BluetoothConfig.Builder() .enableQueueInterval(true)//开启操作时间间隔 .setQueueIntervalTime(BluetoothConfig.AUTO)//单位ms,这里为自动 .build()); //连接蓝牙 connector.connect(true, mBluetoothDevice); connector.connect(true, mBluetoothDevice, BluetoothLeConnector.TRANSPORT_AUTO);//最后一个参数设置连接通道 //开启indicate通知 connector.enableIndication(true,UUID_SERVICE,UUID_INDICATION); //开启notify通知 connector.enableNotification(true, UUID_SERVICE, UUID_NOTIFICATION); //写数据 connector.writeCharacteristic(new byte[]{0x01, 0x02}, UUID_SERVICE, UUID_WRITE); //自定义写数据 BluetoothGattService service = mBluetoothGatt.getService(UUID_SERVICE); BluetoothGattCharacteristic characteristic = service.getCharacteristic(UUID_WRITE); characteristic.setValue(byte[] value); characteristic.setValue(int value, int formatType, int offset); characteristic.setValue(int mantissa, int exponent, int formatType, int offset); characteristic.setValue(String value); connector.writeCharacteristic(characteristic); //读数据 connector.readCharacteristic(UUID_SERVICE, UUID_READ); //断开连接 connector.disconnect(); //关闭gatt connector.close(); 

回调监听

//连接状态监听
private ConnectListener mConnectListener = new ConnectListener() { @Override public void connecting() { } @Override public void connected() { } @Override public void disconnected() { } @Override public void onServicesDiscovered(BluetoothGatt gatt, int status) { } @Override public void error(ConnBleException e) { } }; connector.addConnectListener(mConnectListener);

更多的回调监听如下:

mBleManager.addConnectListener(...)
mBleManager.addNotificationListener(...)
mBleManager.addIndicationListener(...) mBleManager.addWriteCharacteristicListener(...) mBleManager.addReadCharacteristicListener(...) mBleManager.addRssiListener(...)

移除回调监听(好的程序员要懂避免内存泄漏):

connector.removeListener(mConnectListener);

2. 从机Server

广播

private GattServer mGattServer = new GattServer(); mGattServer.startAdvertising(UUID.fromString("0000fff0-0000-1000-8000-00805f9b34fb"));//该uuid可提供给主机client过滤扫描 mGattServer.stopAdvertising();

伺服器server

1. 启动startServer
mGattServer.startServer(context);
2. 关闭closeServer
mGattServer.closeServer();
3. 添加服务addService
List<ServiceProfile> list = new ArrayList<>(); //设置一个写的特征 ServiceProfile profile = new ServiceProfile(); profile.setCharacteristicUuid(UUID.fromString("0000fff3-0000-1000-8000-00805f9b34fb")); profile.setCharacteristicProperties(BluetoothGattCharacteristic.PROPERTY_WRITE); profile.setCharacteristicPermission(BluetoothGattCharacteristic.PERMISSION_WRITE); profile.setDescriptorUuid(GattServer.CLIENT_CHARACTERISTIC_CONFIG_DESCRIPTOR_UUID); profile.setDescriptorPermission(BluetoothGattDescriptor.PERMISSION_READ); profile.setDescriptorValue(new byte[]{0}); list.add(profile); //设置一个读的特征 ServiceProfile profile1 = new ServiceProfile(); profile1.setCharacteristicUuid(UUID.fromString("0000fff2-0000-1000-8000-00805f9b34fb")); profile1.setCharacteristicProperties(BluetoothGattCharacteristic.PROPERTY_READ); profile1.setCharacteristicPermission(BluetoothGattCharacteristic.PERMISSION_READ); profile1.setDescriptorUuid(GattServer.CLIENT_CHARACTERISTIC_CONFIG_DESCRIPTOR_UUID); profile1.setDescriptorPermission(BluetoothGattDescriptor.PERMISSION_READ); profile1.setDescriptorValue(new byte[]{1}); list.add(profile1); //设置一个notify通知 ServiceProfile profile2 = new ServiceProfile(); profile2.setCharacteristicUuid(UUID.fromString("0000fff1-0000-1000-8000-00805f9b34fb")); profile2.setCharacteristicProperties(BluetoothGattCharacteristic.PROPERTY_NOTIFY); profile2.setCharacteristicPermission(BluetoothGattCharacteristic.PERMISSION_READ); profile2.setDescriptorUuid(GattServer.CLIENT_CHARACTERISTIC_CONFIG_DESCRIPTOR_UUID); profile2.setDescriptorPermission(BluetoothGattDescriptor.PERMISSION_WRITE); profile2.setDescriptorValue(new byte[]{1}); list.add(profile2); final ServiceSettings serviceSettings = new ServiceSettings.Builder() .setServiceUuid(UUID.fromString("0000fff0-0000-1000-8000-00805f9b34fb"))//服务uuid .setServiceType(BluetoothGattService.SERVICE_TYPE_PRIMARY) .addServiceProfiles(list)//上述设置添加到该服务里 .build(); mGattServer.addService(serviceSettings);

回调监听

mGattServer.setOnAdvertiseListener(new OnAdvertiseListener() {
            @Override
            public void onStartSuccess(AdvertiseSettings settingsInEffect) { setContentText("开启广播 成功,uuid:0000fff0-0000-1000-8000-00805f9b34fb"); } @Override public void onStartFailure(int errorCode) { setContentText("开启广播 失败,uuid:0000fff0-0000-1000-8000-00805f9b34fb"); } @Override public void onStopAdvertising() { setContentText("停止广播,uuid:0000fff0-0000-1000-8000-00805f9b34fb"); } }); mGattServer.setOnServiceAddedListener(new OnServiceAddedListener() { @Override public void onSuccess(BluetoothGattService service) { setContentText("添加服务成功!"); } @Override public void onFail(BluetoothGattService service) { setContentText("添加服务失败"); } }); mGattServer.setOnConnectionStateChangeListener(new OnConnectionStateChangeListener() { @Override public void onChange(BluetoothDevice device, int status, int newState) { } @Override public void onConnected(BluetoothDevice device) { setContentText("连接上一台设备 :{ name = " + device.getName() + ", address = " + device.getAddress() + "}"); mBluetoothDevice = device; } @Override public void onDisconnected(BluetoothDevice device) { setContentText("设备断开连接 :{ name = " + device.getName() + ", address = " + device.getAddress() + "}"); } }); mGattServer.setOnWriteRequestListener(new OnWriteRequestListener() { @Override public void onCharacteristicWritten(BluetoothDevice device, BluetoothGattCharacteristic characteristic, byte[] value) { setContentText("设备写入特征请求 : device = " + device.getAddress() + ", characteristic uuid = " + characteristic.getUuid().toString() + ", value = " + Arrays.toString(value)); } @Override public void onDescriptorWritten(BluetoothDevice device, BluetoothGattDescriptor descriptor, byte[] value) { setContentText("设备写入描述请求 : device = " + device.getAddress() + ", descriptor uuid = " + descriptor.getUuid().toString() + ", value = " + Arrays.toString(value)); } }); 

Download

dependencies {
  compile 'will be come soon..'
}
展开阅读全文
打赏
0
0 收藏
分享
加载中
更多评论
打赏
0 评论
0 收藏
0
分享
返回顶部
顶部