OpenHarmony BLE藍牙連接

作者：如果雨停了 2023-04-17 16:10:14

系統 OpenHarmony

這里將介紹如何通過OpenHarmony提供的@ohos.bluetooth (藍牙接口)打開當前設備的藍牙，關閉藍牙，以及連接BLE藍牙設備。

??想了解更多關于開源的內容，請訪問：??

??51CTO 開源基礎軟件社區??

??https://ost.51cto.com??

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、實現過程

（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"
        }
      }
    ]

（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
    }
  }

如果當前設備藍牙未打開，則通過調用 bluetooth.enableBluetooth() 藍牙接口來打開藍牙。

// 打開藍牙函數
  initBluetooth() { 
    this.enable = bluetooth.enableBluetooth()
    // 判斷藍牙是否成功打開
    if(this.enable==true){
      prompt.showToast({
        message: 'Open bluetooth  ' + this.enable,
        duration: 2000,
      });
    }
  }

（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)}`)
      }
    })

（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,
      }
    )

（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)}`);
     })
}

在前面通過 bluetooth.BLE.createGattClientDevice(item) 創建一個GattClientDevice實例 BLEDevice 后，我們可以通過該實例去調用 connect() 方法連接BLE設備。注意，GattClientDevice實例只需要創建一個就可以。

OpenHarmony BLE藍牙連接-開源基礎軟件社區

// 連接藍牙
let BLEConnect = this.BLEDevice.connect()
// 如果連接成功，則把BLE設備存入連接成功列表
if(BLEConnect){
  this.deviceBleList.push(item)
}

（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)
                      }
                    }
                  }
                })
              })

在斷開連接、關閉藍牙之后，可以通過 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,
               });
             }
           }
         })