【鸿蒙实战开发】基于短距离通讯的BLE蓝牙扫描

往期知识点整理

• 【鸿蒙UI实战开发】基于List和Scroller由简单到复杂列表布局开发实践
  
• 【鸿蒙ArkUI实战开发】基于ArkUI的透明页面效果
  
• 【鸿蒙ArkUI实战开发】基于Search组件实现搜刮栏
  
• 【鸿蒙ArkUI实战开发】基于Swiper的页面布局
  
• 【鸿蒙ArkUI实战开发】基于promptAction全局弹窗
  
• 【鸿蒙ArkUI实战开发】基于OpenGL渲染视频画面帧
  
• 【鸿蒙实战开发】基于Navigation的路由拦截管理
  
• 【鸿蒙实战开发】基于组件嵌套的滑动
  
• 【鸿蒙实战开发】基于Text的自定义字体
  
• 【鸿蒙实战开发】基于Grid实现混淆布局
  
• 【鸿蒙实战开发】基于ArkUI实现雷同Toast弹窗
  
• 【鸿蒙实战开发】基于短距离通讯的BLE蓝牙扫描
  
• 连续更新中……
  

场景描述

蓝牙是一种短距的无线通讯技术，可实现固定设备、移动设备之间的数据交换。一般将蓝牙3.0之前的BR/EDR蓝牙称为传统蓝牙，而将蓝牙4.0规范下的BLE蓝牙称为低功耗蓝牙。BLE模块提供了对蓝牙操作和管理的方法。
场景一：申请蓝牙权限

方案：
ACCESS_BLUETOOTH 权限是许多蓝牙接口需要申请的，比如：ble.getConnectedBLEDevices（获取和当前设备连接的BLE设备）、ble.startBLEScan（发起BLE扫描流程）。这个权限是需要用户授权的，可以通过调用requestPermissionsFromUser()方法来实现。
不鼓励频仍弹窗打搅用户，假如用户拒绝授权，将无法再次拉起弹窗。需要应用引导用户在系统应用“设置”的界面中手动授予权限。
焦点代码

1. requestPermissionsFromUser() {
2.   let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
3.   try {
4.     let context = getContext(this);
5.     atManager.requestPermissionsFromUser(context, ['ohos.permission.ACCESS_BLUETOOTH'], (err: BusinessError, data: PermissionRequestResult) => {
6.       console.info('data:' + JSON.stringify(data));
7.       console.info('data permissions:' + data.permissions);
8.       console.info('data authResults:' + data.authResults);
9.     });
10.   } catch (err) {
11.     console.log(`catch err->${JSON.stringify(err)}`);
12.   }
13. }

复制代码

配置文件
module.json文件中申请相干权限，相干权限阐明可参考文档：

1. "requestPermissions":[
2.   {
3.     "name" : "ohos.permission.ACCESS_BLUETOOTH",
4.     "reason": "$string:module_desc",
5.     "usedScene": {
6.       "abilities": [
7.         "FormAbility"
8.       ],
9.       "when":"always"
10.     }
11.   },
12.   {
13.     "name" : "ohos.permission.DISCOVER_BLUETOOTH",
14.     "usedScene": {
15.       "abilities": [
16.         "FormAbility"
17.       ],
18.       "when":"always"
19.     }
20.   },
21.   {
22.     "name" : "ohos.permission.USE_BLUETOOTH",
23.     "usedScene": {
24.       "abilities": [
25.         "bluetouth"
26.       ],
27.       "when":"always"
28.     }
29.   },
30. ]

复制代码

场景二：BLE蓝牙扫描和系统设置蓝牙扫描

BLE为低功耗蓝牙，只能扫描到低功耗的蓝牙设备。
connection是经典蓝牙，假如想扫描到系统设置中的所有设备，可以调用此接口。
方案：
ble扫描的是低功耗蓝牙，相比于connection扫描效果偏少，假如想要扫描到系统设置中的所有设备，需要去调用@ohos.bluetooth.connection模块中的connection.startbluetoothdiscovery。
焦点代码
低功耗蓝牙扫描：ble.startBLEScan

1. import { BusinessError } from '@kit.BasicServicesKit';
2. import { ble } from '@kit.ConnectivityKit';
4. @Entry
5. @Component
6. struct Index {
7.   @State onReceiveEventData: string = ''
8.   @State isScan: boolean = false
9.   // ...
11.   build() {
12.     Row() {
13.       Column() {
14.         // 蓝牙扫描
15.         Button("startBLEScan")
16.           .onClick(() => {
17.             this.isScan = !this.isScan
18.             let onReceiveEvent = (data: Array<ble.ScanResult>) => {
19.               console.info('BLE scan device find result = ' + JSON.stringify(data));
20.               let dataString = JSON.stringify(data)
21.               this.onReceiveEventData = dataString
22.             }
23.             try {
24.               ble.on("BLEDeviceFind", onReceiveEvent);
25.               let scanFilter: ble.ScanFilter = {
26.                 // deviceId:"xxxx",
27.                 // name:"test",
28.                 // serviceUuid:"xxxx"
29.               };
30.               console.info('scanFilter' + JSON.stringify(scanFilter))
31.               let scanOptions: ble.ScanOptions = {
32.                 interval: 50,
33.                 dutyMode: ble.ScanDuty.SCAN_MODE_LOW_POWER,
34.                 matchMode: ble.MatchMode.MATCH_MODE_AGGRESSIVE,
35.               }
36.               ble.startBLEScan(null, scanOptions);
37.             } catch (err) {
38.               console.error('errCode: ' + (err as BusinessError).code + ', errMessage: ' +
39.               (err as BusinessError).message);
40.             }
42.           })
43.           .type(ButtonType.Capsule)
44.           .margin({ top: 4 })
45.           .backgroundColor('#ff1198ee')
46.           .width('67%')
47.           .height('4%')
48.         // ...
49.         Text(this.isScan ? this.onReceiveEventData : '蓝牙未开启扫描')
50.           .textAlign(TextAlign.Center)
51.           .fontSize(12)
52.           .border({ width: 1 })
53.           .padding(10)
54.           .margin(10)
55.           .width('80%')
56.           .height(200)
57.       }
58.       .width('100%')
59.     }
60.     .height('100%')
61.   }
62. }

复制代码

经典蓝牙扫描：connection.startBluetoothDiscovery。

1. import { BusinessError } from '@kit.BasicServicesKit';
2. import connection from '@ohos.bluetooth.connection';
4. @Entry
5. @Component
6. struct Index {
7.   @State onReceiveEventData: string = ''
8.   @State isScan: boolean = false
9.   // ...
11.   build() {
12.     Row() {
13.       Column() {
14.         // 蓝牙扫描
15.         Button("startBluetoothDiscovery")
16.           .onClick(() => {
17.             this.isScan = !this.isScan
18.             let onReceiveEvent = (data: Array<string>) => {
19.               console.log('data length' + JSON.stringify(data));
20.               let dataString = JSON.stringify(data)
21.               this.onReceiveEventData = dataString
22.             }
23.             try {
24.               connection.on('bluetoothDeviceFind', onReceiveEvent);
25.               connection.startBluetoothDiscovery();
26.             } catch (err) {
27.               console.error('errCode: ' + (err as BusinessError).code + ', errMessage: ' +
28.               (err as BusinessError).message);
29.             }
30.           })
31.           .type(ButtonType.Capsule)
32.           .margin({ top: 4 })
33.           .backgroundColor('#ff1198ee')
34.           .width('67%')
35.           .height('4%')
36.         Text(this.isScan ? this.onReceiveEventData : '蓝牙未开启扫描')
37.           .textAlign(TextAlign.Center)
38.           .fontSize(12)
39.           .border({ width: 1 })
40.           .padding(10)
41.           .margin(10)
42.           .width('80%')
43.           .height(200)
44.       }
45.       .width('100%')
46.     }
47.     .height('100%')
48.   }
49. }

复制代码

场景三：蓝牙模块能力展示

效果图

方案：
相干接口能力：
⦁    开启蓝牙：access.enableBluetooth。
⦁    关闭蓝牙：access.disableBluetooth。
⦁    获取蓝牙配对列表：connection.getPairedDevices。
⦁    获取蓝牙配对状态：connection.getPairState。
⦁    订阅蓝牙设备发现上报变乱：connection.on(‘bluetoothDeviceFind’)。
⦁    取消订阅蓝牙设备发现上报变乱：connection.off(‘bluetoothDeviceFind’)。
⦁    开启蓝牙扫描，可以发现远端设备：connection.startBluetoothDiscovery。
⦁    关闭蓝牙扫描：connection.stopBluetoothDiscovery。
⦁    发起蓝牙配对：connection.pairDevice。
⦁    创建一个服务端监听Socket：socket.sppListen。
焦点代码

1. GridItem(){
2.   Button('打开权限').onClick(() => {
3.     hilog.info(0x00000, TAG, '打开权限');
4.     this.requestPermissionsFromUser();
5.   })
6. }
7. .columnStart(0)
8. .columnEnd(1)
9. .rowStart(0)
10. .rowEnd(0)
12. GridItem() {
13.   Button('蓝牙-开启').onClick(() => {
14.     hilog.info(0x00000, TAG, '蓝牙-开启');
15.     try {
16.       access.enableBluetooth();
17.     } catch (err) {
18.       hilog.info(0x00000, TAG, 'errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message);
19.     }
20.   })
21. }
23. GridItem() {
24.   Button('蓝牙-关闭').onClick(() => {
25.     hilog.info(0x00000, TAG, '蓝牙-关闭');
26.     try {
27.       access.disableBluetooth();
28.     } catch (err) {
29.       hilog.info(0x00000, TAG, 'errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message);
30.     }
31.   })
32. }
34. GridItem() {
35.   Button('获取蓝牙配对列表&状态').onClick(() => {
36.     hilog.info(0x00000, TAG, '获取蓝牙配对列表');
37.     try {
38.       let result: Array<string> = connection.getPairedDevices();
39.       let index = 1;
40.       result.forEach(s => {
41.         let state = connection.getPairState(s)
42.         hilog.info(0x00000, TAG, '第%{public}s台设备，id-> %{public}s,状态为->%{public}s', index++, s, bluetoothBondStateMap.get(state));
43.       })
44.     } catch (err) {
45.       hilog.info(0x00000, TAG, 'errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message);
46.     }
47.   })
48. }
49. .columnStart(0)
50. .columnEnd(1)
51. .rowStart(1)
52. .rowEnd(1)
54. GridItem() {
55.   Button('订阅蓝牙设备发现上报事件').onClick(() => {
56.     hilog.info(0x00000, TAG, '订阅蓝牙设备发现上报事件。');
57.     try {
58.       connection.on('bluetoothDeviceFind', onReceiveEvent);
59.     } catch (err) {
60.       hilog.info(0x00000, TAG, 'errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message);
61.     }
62.   })
63. }
64. .columnStart(0)
65. .columnEnd(1)
66. .rowStart(2)
67. .rowEnd(2)
68. GridItem() {
69.   Button('取消订阅设备发现上报事件').onClick(() => {
70.     hilog.info(0x00000, TAG, '取消订阅设备发现上报事件');
71.     try {
72.       hilog.info(0x00000, TAG, '共发现了设备数量为-1#' + deviceSet.size);
73.       connection.off('bluetoothDeviceFind', onReceiveEvent);
74.       index = 1;
76.     } catch (err) {
77.       hilog.info(0x00000, TAG, 'errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message);
78.     }
79.   })
80. }
81. .columnStart(0)
82. .columnEnd(1)
83. .rowStart(3)
84. .rowEnd(3)
86. GridItem() {
87.   Button('蓝牙-开启扫描').onClick(() => {
88.     hilog.info(0x00000, TAG, '蓝牙-开启扫描');
89.     try {
90.       connection.startBluetoothDiscovery()
91.     } catch (err) {
92.       hilog.info(0x00000, TAG, 'errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message);
93.     }
94.   })
95. }

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。