当前位置：GHOST系统之家>系统教程 > OpenHarmony BLE蓝牙连接

OpenHarmony BLE蓝牙连接

来源：Ghost系统之家浏览：时间：2023-04-26 09:05:35

想了解更多关于开源的内容，请访问：

51CTO开源基础软件社区

https://ost.51cto.com

OpenHarmony BLE蓝牙设备连接

1、简介

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

2、设备与环境

设备：九联s905l3a机顶盒、开鸿智谷学生卡BLE蓝牙设备系统：OpenHarmony 3.2 beta2SDK：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设备的广播包、地址、信号强度rssibluetooth.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（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 = falsethis.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, }); } } })