OpenHarmony BLE蓝牙连接原创精华

如果雨停了

发布于 2023-4-14 11:30

3175浏览

2收藏

OpenHarmony BLE蓝牙设备连接

1. 简介

OpenHarmony蓝牙模块提供了基础的传统蓝牙能力以及BLE的扫描、广播等功能，这里将介绍如何通过OpenHarmony提供的@ohos.bluetooth (蓝牙接口)打开当前设备的蓝牙，关闭蓝牙，以及连接BLE蓝牙设备。

文末有项目代码

2.设备与环境

设备：九联s905l3a机顶盒、开鸿智谷学生卡BLE蓝牙设备

系统：OpenHarmony 3.2 beta2

SDK：9

演示视频：OpenHarmony BLE蓝牙设备连接

3.逻辑流程

OpenHarmony BLE蓝牙连接-鸿蒙开发者社区

首先机顶盒在开始的时候获取蓝牙相关权限，然后通过OpenHarmony提供的蓝牙接口打开蓝牙，接着订阅发现BLE设备发现事件，然后通过OpenHarmony提供的蓝牙接口开启BLE设备扫描，当发现到了BLE蓝牙设备后，进行上报，BLE设备发现事件触发，获取到来自BLE设备的广播信息包，然后进行BLE蓝牙连接。

4.实现过程

4.1 获取蓝牙相关权限

在使用蓝牙接口之前，首先要让设备获取一下权限：

ohos.permission.USE_BLUETOOTH // 允许应用查看蓝牙的配置。
ohos.permission.DISCOVER_BLUETOOTH // 允许应用配置本地蓝牙，查找远端设备且与之配对连接。
ohos.permission.LOCATION // 允许应用获取设备位置信息。
ohos.permission.MANAGE_BLUETOOTH // 允许应用配对蓝牙设备，并对设备的电话簿或消息进行访问。

打开DevEco Studio 3.1.0.200，创建新的Stage项目，在项目中的module.json文件中添加相关权限：

"requestPermissions": [
      {
        "name": "ohos.permission.USE_BLUETOOTH",
        "reason": "$string:grant_use_bluetooth",
        "usedScene": {
          "abilities": [
            "MainAbility"
          ],
          "when": "inuse"
        }
      },
      {
        "name": "ohos.permission.DISCOVER_BLUETOOTH",
        "reason": "$string:grant_discovery_bluetooth",
        "usedScene": {
          "abilities": [
            "MainAbility"
          ],
          "when": "inuse"
        }
      },
      {
        "name": "ohos.permission.LOCATION",
        "reason": "$string:grant_location",
        "usedScene": {
          "abilities": [
            "MainAbility"
          ],
          "when": "inuse"
        }
      },
      {
        "name": "ohos.permission.MANAGE_BLUETOOTH",
        "reason": "$string:grant_manage_bluetooth",
        "usedScene": {
          "abilities": [
            "MainAbility"
          ],
          "when": "inuse"
        }
      }
    ]1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.

4.2 打开设备的蓝牙

首先，通过调用 bluetooth.getState() 蓝牙接口来获取当前设备蓝牙是否打开，并设置蓝牙开关的标识位 isOn。

async aboutToAppear() {
    // 等待获取蓝牙权限
    await globalThis.abilityContext.requestPermissionsFromUser(['ohos.permission.USE_BLUETOOTH', 'ohos.permission.DISCOVER_BLUETOOTH', 'ohos.permission.LOCATION', 'ohos.permission.MANAGE_BLUETOOTH'])
    logger.info(TAG, `获取权限  grantPermission,requestPermissionsFromUser,PermissionRequestResult`)
    // 获取蓝牙状态
    let state = bluetooth.getState()
    // 判断当前设备蓝牙是否打开
    if (state === bluetooth.BluetoothState.STATE_ON) {
      this.isOn = true
    }
    if (state === bluetooth.BluetoothState.STATE_OFF) {
      this.isOn = false
    }
  }1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.

如果当前设备蓝牙未打开，则通过调用 bluetooth.enableBluetooth() 蓝牙接口来打开蓝牙。

// 打开蓝牙函数
  initBluetooth() { 
    this.enable = bluetooth.enableBluetooth()
    // 判断蓝牙是否成功打开
    if(this.enable==true){
      prompt.showToast({
        message: 'Open bluetooth  ' + this.enable,
        duration: 2000,
      });
    }
  }1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.

4.3 注册发现BLE设备监听器

在设备打开蓝牙之后，通过调用 bluetooth.BLE.on('BLEDeviceFind') 蓝牙接口来订阅BLE设备发现上报事件。该接口参数如下：

OpenHarmony BLE蓝牙连接-鸿蒙开发者社区

通过注册发现BLE设备监听器，可以得到发现设备的集合，BLE设备的广播包、地址、信号强度rssi，在这里发现获取连接BLE设备名字的接口 getDeviceName 无法成功调用，所以自己通过解析广播包来获取设备名字。

    // 订阅BLE设备发现上报事件
    // 获取到的data包括BLE设备的广播包、地址、信号强度rssi
    bluetooth.BLE.on('BLEDeviceFind', (data) => {
      logger.info(TAG, `enter on bluetoothBLEDeviceFind`)
      logger.info("rgytl 开始扫描设备地址！  1")
      if (data !== null && data.length > 0) {
        logger.info("rgytl 开始扫描设备地址！  2")
        if (this.discoveryBleList.indexOf(data[0]) === -1) {
          // 把发现的设备地址存入列表
          this.discoveryBleList.push(data[0].deviceId)
          logger.info("rgytl ---- discoveryBleList = "+JSON.stringify(this.discoveryBleList))
          // 读取广播包，解析广播包，得到设备名字，并存入设备列表
          var i = 0;
          var x = data[0].data[i]
          var y = data[0].data[i + 1]
          while(y!=0x09 && i+x+2<data[0].data.byteLength){
            i = i+x+1
            x = data[0].data[i]
            y = data[0].data[i+1]
          }

          let arr = data[0].data.slice(i+2,i+x+1)

          var BLEName = ""
          for(let j=0;j<arr.byteLength;j++){
            BLEName+=String.fromCharCode(arr[j])
          }
          logger.info("rgytl ---- discoveryBleList = "+BLEName)
          // 把通过广播包解析的BLE设备名字存入设备名字列表
          this.BleInfo.push(BLEName)
          // 把发现的BLE设备信号存入设备信号强度列表
          this.BleRssi.push(data[0].rssi)
          logger.info("rgytl ---- discoveryBleList = "+data[0].rssi)
        }
        logger.info(TAG, `开启扫描  discoveryBleList = ${JSON.stringify(this.discoveryBleList)}`)
      }
    })1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.

4.4 开启BLE设备扫描

在完成订阅BLE设备发现上报事件后，通过调用 bluetooth.BLE.startBLEScan 接口去开启BLE设备扫描，通过该接口，可以对扫描BLE设备进行过滤，可以过滤的参数有：BLE设备的地址、名字、以及服务的UUID等。

OpenHarmony BLE蓝牙连接-鸿蒙开发者社区

在这里，我设置只扫描包含我BLE设备名字的BLE设备，这样子就不会说扫描到一大堆其他的BLE设备，影响使用，只需要开启一次扫描和订阅一次BLE设备发现上报事件就可以了，使用的时候只要没有关闭，就不需要重复调用。

// 设置蓝牙BLE扫描模式（根据名字扫描）
    bluetooth.BLE.startBLEScan(
      [{
         deviceId: null,
         name: "ble slave test",
         serviceUuid: null
       }],
      {
        interval: 0,
        dutyMode: bluetooth.ScanDuty.SCAN_MODE_LOW_POWER,
        matchMode: bluetooth.MatchMode.MATCH_MODE_AGGRESSIVE,
      }
    )1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.

4.5 连接BLE设备

在扫描到BLE设备之后，可以通过 on(‘BLEConnectionStateChange’) 来订阅获取BLE设备的连接状态变化事件，在使用该接口之前，要先通过 bluetooth.BLE.createGattClientDevice('XX:XX:XX:XX:XX:XX') 接口创建一个可使用的GattClientDevice实例。

OpenHarmony BLE蓝牙连接-鸿蒙开发者社区

// 订阅BEL状态变化
if(this.BleOnflag){
    // 只创建一个GattClient对象
	this.BleOnflag = false
    this.BLEDevice = bluetooth.BLE.createGattClientDevice(item);
    // 订阅获取BLE设备的连接状态变化事件
    this.BLEDevice.on('BLEConnectionStateChange', (data) => {
    console.log('bluetooth connectState state changed');
    let connectState = data.state;
    // 根据不通的连接状态，提示不同的信息
    if(JSON.stringify(connectState) == 0){
    	logger.info(`connectState = ${JSON.stringify(connectState)},断开连接`)
     	prompt.showToast({
     		message: '断开连接',
            duration: 2000,
        });
     } else if(JSON.stringify(connectState) == 2){
      	logger.info(`connectState = ${JSON.stringify(connectState)},连接成功`)
        prompt.showToast({
        	message: '连接成功',
            duration: 2000,
        });
     } else if(JSON.stringify(connectState) == 1){
     	logger.info(`connectState = ${JSON.stringify(connectState)},正在连接`)
     } else {
        logger.info(`connectState = ${JSON.stringify(connectState)},正在断连`)
     }
     logger.info(`connectState = ${JSON.stringify(connectState)}`);
     })
}1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.

在前面通过 bluetooth.BLE.createGattClientDevice(item) 创建一个GattClientDevice实例 BLEDevice 后，我们可以通过该实例去调用 connect() 方法连接BLE设备。注意，GattClientDevice实例只需要创建一个就可以。

OpenHarmony BLE蓝牙连接-鸿蒙开发者社区

// 连接蓝牙
let BLEConnect = this.BLEDevice.connect()
// 如果连接成功，则把BLE设备存入连接成功列表
if(BLEConnect){
	this.deviceBleList.push(item)
}1.
2.
3.
4.
5.
6.

4.6 结尾处理

当不连接BLE设备的时候，要记得关闭BLE设备扫描，取消订阅设备发现事件。

取消BLE设备连接，通过之前创建的GattClientDevice实例 BLEDevice 调用 disconnect() 方法断开连接BLE设备。

Button("断开")
              .alignSelf(ItemAlign.Center)
              .onClick(() => {
                AlertDialog.show({
                  title: $r('app.string.disconnect'),
                  message: '此操作将会断开该设备的连接',
                  primaryButton: {
                    value: $r('app.string.cancel'),
                    action: () => {
                    }
                  },
                  secondaryButton: {
                    value: $r('app.string.confirm'),
                    action: () => {
                      // 断开连接BLE设备
                      let BLEdisConnect = this.BLEDevice.disconnect()
                      if(BLEdisConnect){
                        logger.info(`connectState BLEdisConnect = ${JSON.stringify(BLEdisConnect)},断开连接`)
                        // 移出BLE设备连接列表
                        this.deviceBleList.pop(item)
                      }
                    }
                  }
                })
              })1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.

在断开连接、关闭蓝牙之后，可以通过 off(‘connectStateChange’) 取消订阅BLE连接状态变化事件、bluetooth.BLE.stopBLEScan 停止BLE扫描、以及 bluetooth.BLE.off(‘BLEDeviceFind’) 取消订阅BLE设备发现上报事件，最后通过 bluetooth.disableBluetooth() 关闭蓝牙。

.onChange((isOn: boolean) => {
             if (isOn) {
               this.isOn = true
               this.initBluetooth()
             } else {
               this.isOn = false
               bluetooth.BLE.off('BLEDeviceFind',()=>{
                 logger.info("rgytl 取消BLE设备发现订阅！")
             })
             bluetooth.BLE.stopBLEScan()
             this.disable = bluetooth.disableBluetooth()
             this.discoveryList = []
             this.BleInfo = []
             this.BleRssi = []
             if(this.disable==true){
               prompt.showToast({
                 message: 'Close bluetooth  ' + this.disable,
                 duration: 2000,
               });
             }
           }
         })1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.