FastBle-master.zip蓝牙快速开发框架

# FastBle Ohos Bluetooth Low Energy 蓝牙快速开发框架。 openHarmonyOs，使用简单的方式进行搜索、连接、读写等一系列蓝牙操作，并实时地得到操作反馈。 # Preview <img src="screenshot/Screenshot_1.jpg" height="30%" width="30%"/>|<img src="screenshot/Screenshot_2.jpg" height="30%" width="30%"/>|<img src="screenshot/Screenshot_3.jpg" height="30%" width="30%"/>| <img src="screenshot/Screenshot_4.jpg" height="30%" width="30%"/>|<img src="screenshot/Screenshot_5.jpg" height="30%" width="30%"/>|<img src="screenshot/Screenshot_6.jpg" height="30%" width="30%"/>| <img src="screenshot/Screenshot_7.jpg" height="30%" width="30%"/>|<img src="screenshot/Screenshot_8.jpg" height="30%" width="30%"/>|<img src="screenshot/Screenshot_9.jpg" height="30%" width="30%"/>| <img src="screenshot/Screenshot_10.jpg" height="30%" width="30%"/>|<img src="screenshot/Screenshot_11.jpg" height="30%" width="30%"/>|<img src="screenshot/Screenshot_12.jpg" height="30%" width="30%"/>| # Usage 通过DevEco studio 2.0+,并下载SDK Native 版本2.0+ 方式一 在entry的gradle中集成如下操作： 如果使用har,请将har放到entry中的libs 修改implementation fileTree(dir: 'libs', include: ['*.jar','*.har'])增加*.har 方式二 ``` allprojects{ repositories{ mavenCentral() } } implementation 'io.openharmony.tpc.thirdlib:fastblelib:1.0.4' ``` - #### 初始化，创建操作对象 后续的所有操作方法，均通过当前所创建的BleManager对象来完成 ``` BleManager.getInstance().init(this); BleManager.getInstance() .enableLog(true) .setReConnectCount(1, 5000) .setConnectOverTime(20000) .setOperateTimeout(5000); ``` - #### 判断当前手机是否支持BLE boolean isSupportBle() - #### 开启或关闭蓝牙 void enableBluetooth() void disableBluetooth() - #### 查看当前蓝牙状态或连接状态 boolean isBlueEnable() boolean isInScanning() boolean isConnectingOrConnected() boolean isConnected() boolean isServiceDiscovered() - #### 打印异常信息 `void handleException(BleException exception)` bleManager.handleException(exception); - #### ListScanCallback(long timeoutMillis) 普通扫描的Callback long timeoutMillis: 本次扫描的时间 void onScanning(ScanResult result): 当前正在扫描状态，且搜索到一个外围设备的回调 void onScanComplete(ScanResult[] results): 扫描时间到或手动取消扫描后的回调 ScanResult: 表示返回的扫描结果对象 BluetoothDevice getDevice(): 蓝牙设备对象 byte[] getScanRecord(): 广播数据; int getRssi(): 信号强度 - #### BleGattCallback 扫描并连接的Callback void onFoundDevice(ScanResult scanResult): 找到设备的回调； void onConnecting(BluetoothGatt gatt, int status): 正在连接的回调； void onConnectError(BleException exception)： 连接未成功的回调，通过解析BleException来判断具体未成功的原因； void onConnectSuccess(BluetoothGatt gatt, int status): 连接成功的回调； void onServicesDiscovered(BluetoothGatt gatt, int status): 发现服务的回调； void onDisConnected(BluetoothGatt gatt, int status, BleException exception): 连接断开的回调，特指连接之后的断开。 - #### BleCharacterCallback Characteristic操作的Callback void onSuccess(BluetoothGattCharacteristic characteristic): 数据传输回调； void onFailure(BleException exception)： 操作或数据传输过程中出错； void onInitiatedResult(boolean result): 操作成功与否的回调； - #### BleRssiCallback 读Rssi操作的Callback void onSuccess(int rssi): 得到rssi数据的回调； void onFailure(BleException exception)： 操作或数据传输过程中出错； void onInitiatedResult(boolean result): 操作成功与否的回调； - #### BleException int getCode(): 获取异常码； String getDescription()： 获取异常描述； 异常码： - 100： 超时 - 101： 连接异常 - 102： 其他（异常信息可以通过异常描述获取，一般是开发过程中的操作中间步骤的异常） - 103： 设备未找到 - 104： 蓝牙未启用 - 105： 开启扫描过程失败 - #### 扫描所有设备 可获得周围蓝牙设备对象数组 `boolean scanDevice(ListScanCallback callback)` 返回值表示扫描操作是否成功，具体扫描结果会显示在ListScanCallback的回调方法中。 bleManager.scanDevice(new ListScanCallback(TIME_OUT) { @Override public void onScanning(ScanResult result) { } @Override public void onScanComplete(ScanResult[] results) { } }); - #### 连接设备 当搜索到周围设备之后，可以选择选择某一个设备和其连接 `void connectDevice(ScanResult scanResult, boolean autoConnect, BleGattCallback callback)` bleManager.connectDevice(scanResult, true, new BleGattCallback() { @Override public void onConnecting(BluetoothGatt gatt, int status) { } @Override public void onConnectError(BleException exception) { } @Override public void onConnectSuccess(BluetoothGatt gatt, int status) { } @Override public void onServicesDiscovered(BluetoothGatt gatt, int status) { } @Override public void onDisConnected(BluetoothGatt gatt, int status, BleException exception) { } }); - #### 停止扫描 取消扫描操作 `void cancelScan()` bleManager.cancelScan(); - #### 订阅通知notify `boolean notify(String uuid_service, String uuid_notify, BleCharacterCallback callback)` 返回值表示notify操作是否成功，BleCharacterCallback()中的onInitiatedResult也表示本次操作是否成功，功能一致，便于不同情况下的用途。 bleManager.notify( UUID_SERVICE, UUID_NOTIFY, new BleCharacterCallback() { @Override public void onSuccess(BluetoothGattCharacteristic characteristic) { } @Override public void onFailure(BleException exception) { } @Override public void onInitiatedResult(boolean result) { } }); - #### 取消订阅通知notify，并移除回调监听 `boolean stopNotify(String uuid_service, String uuid_notify)` 返回值表示stopNotify操作是否成功，BleCharacterCallback()中的onInitiatedResult也表示本次操作是否成功，功能一致，便于不同情况下的用途。 bleManager.stopNotify(UUID_SERVICE, UUID_NOTIFY); - #### 订阅通知indicate `boolean indicate(String uuid_service, String uuid_indicate, BleCharacterCallback callback)` 返回值表示indicate操作是否成功，BleCharacterCallback()中的onInitiatedResult也表示本次操作是否成功，功能一致，便于不同情况下的用途。 bleManager.indicate( UUID_SERVICE, UUID_INDICATE, new BleCharacterCallback() { @Override public void onSuccess(BluetoothGattCharacteristic characteristic) { } @Override public void onFailure(BleException exception) { } @Override public void onInitiatedResult(boolean result) { }