HarmonyOS学习路之开发篇—网络与连接（蓝牙开发 二）_蓝牙模块开发是用openharmony还是harmonyos

BLE扫描和广播

场景介绍

通过BLE扫描和广播提供的开放能力，可以根据指定状态获取外围设备、启动或停止BLE扫描、广播。

接口说明

中心设备进行BLE扫描

1. 进行BLE扫描之前先要继承BleCentralManagerCallback类实现scanResultEvent和scanFailedEvent回调函数，用于接收扫描结果。
2. 调用BleCentralManager(BleCentralManagerCallback callback)接口获取中心设备管理对象。
3. 获取扫描过滤器，过滤器为空时为不使用过滤器扫描，然后调用startScan()开始扫描BLE设备，在回调中获取扫描到的BLE设备。

// 实现扫描回调
public class ScanCallback implements BleCentralManagerCallback{
    List<BleScanResult> results = new ArrayList<BleScanResult>();
    @Override
    public void scanResultEvent(BleScanResult resultCode) {
        // 对扫描结果进行处理
        results.add(resultCode);
    }
    @Override    
    public void scanFailedEvent(int resultCode) {        
        HiLog.warn(TAG,"Start Scan failed, Code: %{public}d", resultCode);    
    }
    @Override
    public void groupScanResultsEvent​(final List<BleScanResult> scanResults){
        // 对扫描结果进行处理
    }
}
// 获取中心设备管理对象
private ScanCallback centralManagerCallback = new ScanCallback();
private BleCentralManager centralManager = new BleCentralManager(context, centralManagerCallback);
// 创建扫描过滤器然后开始扫描
List<BleScanFilter> filters = new ArrayList<BleScanFilter>();
centralManager.startScan(filters);

外围设备进行BLE广播

1. 进行BLE广播前需要先继承advertiseCallback类实现startResultEvent回调，用于获取广播结果。
2. 调用接口BleAdvertiser(Context context, BleAdvertiseCallback callback)获取广播对象，构造广播参数和广播数据。
3. 调用startAdvertising(BleAdvertiseSettings settings, BleAdvertiseData advData, BleAdvertiseData scanResponse)接口开始BLE广播。

// 实现BLE广播回调
private BleAdvertiseCallback advertiseCallback = new BleAdvertiseCallback() {
    @Override    
    public void startResultEvent(int result) {
        if(result == BleAdvertiseCallback.RESULT_SUCC){
            // 开始BLE广播成功
        }else {
            // 开始BLE广播失败
        }
    }
};
// 获取BLE广播对象
private BleAdvertiser advertiser = new BleAdvertiser(this,advertiseCallback);
// 创建BLE广播参数和数据
private BleAdvertiseData data = new BleAdvertiseData.Builder()           
                        .addServiceUuid(SequenceUuid.uuidFromString(Server_UUID)) // 添加服务的UUID                  
                        .addServiceData(SequenceUuid.uuidFromString(Server_UUID), new byte[]{0x11}) // 添加广播数据内容
                        .build();
private BleAdvertiseSettings advertiseSettings = new BleAdvertiseSettings.Builder()                        
                       .setConnectable(true) // 设置是否可连接广播
                       .setInterval(BleAdvertiseSettings.INTERVAL_SLOT_DEFAULT) // 设置广播间隔
                       .setTxPower(BleAdvertiseSettings.TX_POWER_DEFAULT) // 设置广播功率
                       .build();
// 开始广播
advertiser.startAdvertising(advertiseSettings, data, null);

BLE中心设备与外围设备进行数据交互

场景介绍

BLE外围设备和中心设备建立GATT连接，通过该连接中心设备可以获取外围设备支持的Service、Characteristic​、Descriptor、RSSI等数据。同时，中心设备可以向外围设备进行数据请求，并向外围设备写入Characteristic、Descriptor等特征值数据。

接口说明

低功耗蓝牙外围设备操作类BlePeripheralDevice的接口说明如下。

低功耗蓝牙外围设备操作回调类BlePeripheralCallback的接口说明如下。

开发步骤

1. 调用startScan()接口启动BLE扫描来获取外围设备。
2. 获取到外围设备后，调用connect(boolean isAutoConnect, BlePeripheraCallback callback)建立与外围BLE设备的GATT连接，boolean参数isAutoConnect用于设置是否允许设备在可发现距离内自动建立GATT连接。
3. 启动GATT连接后，会触发connectionStateChangeEvent(int connectionState)回调，根据回调结果判断是否连接GATT成功。
4. 在GATT连接成功时，中心设备可以调用discoverServices()接口，获取外围设备支持的Services、Characteristics等特征值，在回调servicesDiscoveredEvent(int status)中获取外围设备支持的服务和特征值，并根据UUID判断是什么服务。
5. 根据获取到的服务和特征值，调用read和write方法可以读取或者写入对应特征值数据。

private List<GattService> services;
// 创建扫描过滤器然后开始扫描
List<BleScanFilter> filters = new ArrayList<BleScanFilter>();
centralManager.startScan(filters);
// 与外围设备建立连接，允许自动回连，连接会触发connectionStateChangeEvent回调
private BlePeripheralDevice peripheralDevice = BlePeripheralDevice.createInstance(address); // address为远端设备地址
MyBlePeripheralCallback callback = new MyBlePeripheralCallback();
peripheralDevice.connect(true, callback);
// 连接后读取外围设备RSSI值，获取后触发readRemoteRssiEvent()回调
peripheralDevice.readRemoteRssiValue();
 
// 实现外围设备操作回调
private class MyBlePeripheralCallback extends BlePeripheralCallback {
    @Override
    public void connectionStateChangeEvent(int connectionState) { // GATT连接状态变化回调
        if (connectionState == ProfileBase.STATE_CONNECTED){
            peripheralDevice.discoverServices(); // 连接成功获取外围设备的Service
        } 
    }
 
    @Override
    public void servicesDiscoveredEvent(int status) { // 获取外围设备Service的回调
        if (status == BlePeripheralDevice.OPERATION_SUCC){
            services = peripheralDevice.getServices(); // 获取Service成功后获服务列表
            for (GattService service : services){
                // 对每个服务进行相应操作
            }
        }
    }
 
    @Override
    public void characteristicChangedEvent(GattCharacteristic charecteristic) { // 外围设备主动向中心设备发送特征值通知时触发回调
        // 根据通知的charecteristic获取特征值携带的数据
    }
 
    @Override
    public void characteristicWriteEvent(GattCharacteristic charecteristic, int ret) {
        if (ret == BlePeripheralDevice.OPERATION_SUCC){
            // 向外围设备写特征值数据成功后的操作
        }
    }
 
    @Override
    public void characteristicReadEvent(GattCharacteristic charecteristic, int ret) {
        if (ret == BlePeripheralDevice.OPERATION_SUCC){
            // 向外围设备读特征值数据成功后的操作
        }
    }
 
    @Override
    public void descriptorReadEvent(GattDescriptor descriptor, int ret) {
            // 向外围设备读描述值数据成功后的操作
    }
 
    @Override
    public void descriptorWriteEvent(GattDescriptor descriptor, int ret) {
           // 向外围设备写描述值数据成功后的操作
    }
 
    @Override
    public void readRemoteRssiEvent(int rssi, int ret) {   
        if (ret == BlePeripheralDevice.OPERATION_SUCC){
            // 读取外围设备RSSI值成功后的操作，对端RSSI值为rssi
        }
    }
}

BLE外围设备数据管理

场景介绍

BLE外围设备作为服务端，可以接收来自中心设备（客户端）的GATT连接请求，应答来自中心设备的特征值内容读取和写入请求，并向中心设备提供数据，从而实现信息交互和消息同步。同时外围设备还可以主动向中心设备发送数据。

接口说明

低功耗蓝牙外围设备操作类BlePeripheralManager的接口说明如下。

低功耗蓝牙外围设备管理回调类BlePeripheralManagerCallback的接口说明如下。

开发步骤

1. 调用BlePeripheralManager(Context context, BlePeripheralManagerCallback callback, int transport)接口创建外围设备服务端并开启服务。
2. 调用GattService(UUID uuid, boolean isPrimary)接口创建服务对象，向外围设备添加服务。
3. 从回调接口onCharacteristicWriteRequest中获取中心设备发送来的消息，调用notifyCharacteristicChanged接口向中心设备发送通知。

private BlePeripheralDevice blePeripheralDevice;
private MyBlePeripheralManagerCallback peripheralManagerCallback = new MyBlePeripheralManagerCallback();
// 创建外围设备服务端并开启服务
private BlePeripheralManager peripheralManager = new BlePeripheralManager(this, peripheralManagerCallback, 0);
// 创建服务对象，向外围设备添加服务
private GattService service = new GattService(UUID.fromString(Service_UUID), true);
private GattCharacteristic writeCharacteristic = new GattCharacteristic(Character_UUID, 
GattCharacteristic.PROPERTY_WRITE, GattCharacteristic.PROPERTY_WRITE);
service.addCharacteristic(writeCharacteristic);
peripheralManager.addServerService(service);
// 向中心设备发送通知
writeCharacteristic.setValue(data);
peripheralManager.notifyCharacteristicChanged(blePeripheralDevice, writeCharacteristic, false);
 
// 外围设备管理回调
public class MyBlePeripheralManagerCallback extends BlePeripheralManagerCallback {
    // 中心设备向外围设备写入数据回调
    @Override
    public void receiveCharacteristicWriteEvent(BlePeripheralDevice device, int requestId, 
        GattCharacteristic characteristic, boolean isPrep, boolean needRsp, int offset, byte[] value){ 
            // 中心设备写入外围设备的数据为value，对数据进行处理
    }
    // 外围设备连接状态变化回调
    @Override
    public void connectionStateChangeEvent(BlePeripheralDevice device, int interval, int latency, int timeout, int status){
        if (status == ProfileBase.STATE_CONNECTED) {
            // 中心设备连接服务端成功
            blePeripheralDevice = device;
        }
    }
    // 向中心设备发送通知回调
    @Override
    public void notificationSentEvent(BlePeripheralDevice device, int status){
        if (status == BlePeripheralDevice.OPERATION_SUCC) {
            // 向对中心设备发送通知成功回调
        }
    }
}