鸿蒙Harmony开辟案例教程：如何举行蓝牙设备发现、配对、取消配对功能 ...

tsx81429 · 2024-8-4 00:20:42

如何举行蓝牙毗连

场景说明

蓝牙技能是一种无线数据和语音通信开放的举世规范，它是基于低本钱的近距离无线毗连，为固定和移动设备建立通信环境的一种特殊的毗连。本示例通过@ohos.bluetoothManager接口实现蓝牙设备发现、配对、取消配对功能。
效果呈现

本示例终极效果如下：
发现设备毗连设备断开毗连

点击领取→纯血鸿蒙Next全套最新学习资料
运行环境

本例基于以下环境开辟，开辟者也可以基于其他适配的版本举行开辟。

IDE：DevEco Studio 3.1.1 Release
SDK：Ohos_sdk_full 4.0.8.5(API Version 10 Beta1)

实现思路

本文涉及到蓝牙的设备发现、配对、取消配对三个功能特性，实现思路如下：

启动和关闭蓝牙：在Index页面中通过Toggle组件的onChange函数控制蓝牙的开关，开关打开的环境下实行initBluetooth函数，关闭的环境下实行bluetooth.disableBluetooth()方法来断开蓝牙；
验证蓝牙是否处于毗连状态：蓝牙打开的时候通过bluetooth.on('stateChange')方法监听蓝牙毗连状态改变变乱，如确认已打开，实行foundDevices()函数来查找设备接口，确认已关闭则实行bluetooth.stopBluetoothDiscovery()方法制止查询接口。
发现设备：在foundDevices()函数中通过bluetooth.on('bluetoothDeviceFind')方法监听设备发现变乱，通过bluetooth.getPairedDevices()方法更新已配对蓝牙地址，然后通过bluetooth.startBluetoothDiscovery()方法开启蓝牙扫描发现远端设备，并且通过bluetooth.setBluetoothScanMode()方法来被远端设备发现。
蓝牙配对：通过bluetooth.on('pinRequired')方法监听远端蓝牙设备的配对请求变乱，点击配对实行bluetooth.setDevicePairingConfirmation(this.data.deviceId, true)方法，点击取消实行bluetooth.setDevicePairingConfirmation(this.data.deviceId, false)方法。
取消配对：使用bluetooth.cancelPairedDevice()断开指定的远端设备毗连。

开辟步调

申请蓝牙权限。使用蓝牙需要先申请对应的权限，在module.json5文件中添加以下配置：
1. "requestPermissions": [
2. {
3. //允许应用查看蓝牙的配置
4. "name": "ohos.permission.USE_BLUETOOTH",
5. "reason": "$string:grant_use_bluetooth",
6. "usedScene": {
7. "abilities": [
8. "MainAbility"
9. ],
10. "when": "inuse"
11. }
12. },
13. {
14. //允许应用配置本地蓝牙，查找远端设备且与之配对连接
15. "name": "ohos.permission.DISCOVER_BLUETOOTH",
16. "reason": "$string:grant_discovery_bluetooth",
17. "usedScene": {
18. "abilities": [
19. "MainAbility"
20. ],
21. "when": "inuse"
22. }
23. },
24. {
25. //允许应用获取设备位置信息
26. "name": "ohos.permission.LOCATION",
27. "reason": "$string:grant_location",
28. "usedScene": {
29. "abilities": [
30. "MainAbility"
31. ],
32. "when": "inuse"
33. }
34. },
35. {
36. //允许应用获取设备模糊位置信息
37. "name": "ohos.permission.APPROXIMATELY_LOCATION",
38. "reason": "$string:grant_location",
39. "usedScene": {
40. "abilities": [
41. "MainAbility"
42. ],
43. "when": "inuse"
44. }
45. },
46. {
47. //允许应用配对蓝牙设备，并对设备的电话簿或消息进行访问
48. "name": "ohos.permission.MANAGE_BLUETOOTH",
49. "reason": "$string:grant_manage_bluetooth",
50. "usedScene": {
51. "abilities": [
52. "MainAbility"
53. ],
54. "when": "inuse"
55. }
56. }
57. ]
复制代码
构建UI框架，团体的UI框架分为TitleBar（页面名称），PinDialog（配对蓝牙弹框），index（主页面）三个部分。
1. //Common/TitleBar.ets
2. @Component
3. export struct TitleBar {
4. private handlerClickButton: () => void
6. build() {
7. Row() {
8. Image($r('app.media.ic_back'))
9. .width(40)
10. .height(30)
11. .onClick(() => {
12. this.handlerClickButton()
13. })
14. Text($r('app.string.bluetooth'))
15. .fontSize(30)
16. .width(150)
17. .height(50)
18. .margin({ left: 15 })
19. .fontColor('#ffa2a3a4')
20. }
21. .width('100%')
22. .height(60)
23. .padding({ left: 20, top: 10 })
24. .backgroundColor('#ff2d30cb')
25. .constraintSize({ minHeight: 50 })
26. }
27. }
29. //Common/PinDalog.ets
30. ...
31. aboutToAppear() {
32. this.titleText = `"${this.data.deviceId}"要与您配对。请确认此配对码已在"${this.data.deviceId}"上直接显示，且不是手动输入的。`
33. this.pinCode = JSON.stringify(this.data.pinCode)
34. }
35. build() {
36. //配对弹框描述文字
37. Column({ space: 10 }) {
38. Text($r('app.string.match_request'))
39. .fontSize(30)
40. .alignSelf(ItemAlign.Start)
41. Text(this.titleText)
42. .alignSelf(ItemAlign.Start)
43. .margin({ top: 20 })
44. .fontSize(21)
45. Text(this.pinCode)
46. .fontSize(40)
47. .fontWeight(FontWeight.Bold)
48. .margin({ top: 20 })
49. Flex({ direction: FlexDirection.Row, alignItems: ItemAlign.Center }) {
50. Checkbox({ name: 'checkbox' })
51. .select(false)
52. .selectedColor('#ff3d6fb8')
53. .key('checkBox')
54. Text($r('app.string.grant_permission'))
55. .fontSize(15)
56. .margin({ left: 3, top: 6 })
57. }
58. .alignSelf(ItemAlign.Start)
59. .width('95%')
60. .margin({ top: 5 })
62. Row() {
63. //配对选择UI，取消or配对
64. this.choiceText($r('app.string.cancel'), () => {
65. bluetooth.setDevicePairingConfirmation(this.data.deviceId, false)
66. logger.info(TAG, `setDevicePairingConfirmation = ${bluetooth.setDevicePairingConfirmation(this.data.deviceId, false)}`)
67. this.controller.close()
68. })
70. Divider()
71. .vertical(true)
72. .height(32)
74. this.choiceText($r('app.string.match'), () => {
75. bluetooth.setDevicePairingConfirmation(this.data.deviceId, true)
76. logger.info(TAG, `setDevicePairingConfirmation = ${bluetooth.setDevicePairingConfirmation(this.data.deviceId, true)}`)
77. this.controller.close()
78. })
79. }
80. .margin({ top: 20 })
81. }
82. .width('100%')
83. .padding(15)
84. }
85. ...
87. //pages/index.ets
88. @Entry
89. @Component
90. struct Index {
91. build() {
92. Column() {
93. TitleBar({ handlerClickButton: this.handlerClickButton })
94. Scroll() {
95. Column() {
96. Row() {
97. //蓝牙开关
98. Column() {
99. Text($r('app.string.bluetooth'))
100. .fontSize(30)
101. .margin({ top: 20 })
102. .alignSelf(ItemAlign.Start)
103. if (true === this.isOn) {
104. Text($r('app.string.discovery'))
105. .fontSize(20)
106. .alignSelf(ItemAlign.Start)
107. }
108. }
110. Blank()
112. Column() {
113. Toggle({ type: ToggleType.Switch, isOn: this.isOn })
114. .selectedColor('#ff2982ea')
115. .onChange((isOn: boolean) => {
116. if (isOn) {
117. this.isOn = true
118. this.initBluetooth()
119. } else {
120. this.isOn = false
121. bluetooth.disableBluetooth()
122. this.deviceList = []
123. this.discoveryList = []
124. }
125. })
126. }
127. .id('toggleBtn')
128. }
129. .width('90%')
131. if (this.isOn) {
132. Divider()
133. .vertical(false)
134. .strokeWidth(10)
135. .color('#ffece7e7')
136. .lineCap(LineCapStyle.Butt)
137. .margin('1%')
138. //已配对的设备
139. Text($r('app.string.paired_device'))
140. .fontSize(25)
141. .fontColor('#ff565555')
142. .margin({ left: '5%' })
143. .alignSelf(ItemAlign.Start)
145. ForEach(this.deviceList, (item, index) => {
146. Row() {
147. Text(item)
148. .fontSize(20)
149. }
150. .alignSelf(ItemAlign.Start)
151. .width('100%')
152. .height(50)
153. .margin({ left: '5%', top: '1%' })
154. .id(`pairedDevice${index}`)
155. .onClick(() => {
156. AlertDialog.show({
157. //取消配对
158. title: $r('app.string.disconnect'),
159. message: '此操作将会断开您与以下设备的连接：' + item,
160. primaryButton: {
161. value: $r('app.string.cancel'),
162. action: () => {
163. }
164. },
165. //确认取消
166. secondaryButton: {
167. value: $r('app.string.confirm'),
168. action: () => {
169. try {
170. bluetooth.cancelPairedDevice(item);
171. this.deviceList = bluetooth.getPairedDevices()
172. this.discoveryList = []
173. bluetooth.startBluetoothDiscovery()
174. } catch (err) {
175. console.error("errCode:" + err.code + ",errMessage:" + err.message);
176. }
177. }
178. }
179. })
180. })
181. })
183. Divider()
184. .vertical(false)
185. .strokeWidth(10)
186. .color('#ffece7e7')
187. .lineCap(LineCapStyle.Butt)
188. .margin('1%')
190. Text($r('app.string.available_device'))
191. .fontSize(25)
192. .fontColor('#ff565555')
193. .margin({ left: '5%', bottom: '2%' })
194. .alignSelf(ItemAlign.Start)
195. //可用设备列表
196. ForEach(this.discoveryList, (item) => {
197. Row() {
198. Text(item)
199. .fontSize(20)
200. }
201. .alignSelf(ItemAlign.Start)
202. .width('100%')
203. .height(50)
204. .margin({ left: '5%', top: '1%' })
205. //进行配对操作点击
206. .onClick(() => {
207. logger.info(TAG, `start bluetooth.pairDevice,item = ${item}`)
208. let pairStatus = bluetooth.pairDevice(item)
209. logger.info(TAG, `pairStatus = ${pairStatus}`)
210. })
212. Divider()
213. .vertical(false)
214. .color('#ffece7e7')
215. .lineCap(LineCapStyle.Butt)
216. .margin('1%')
217. })
218. }
219. }
220. }
221. .constraintSize({ maxHeight: '85%' })
222. }
223. }
224. }
复制代码
蓝牙开关打开关闭利用，需要打开蓝牙开关才能举行后续利用：
1. initBluetooth() {
2. bluetooth.on('stateChange', (data) => {
3. logger.info(TAG, `enter on stateChange`)
4. //判断蓝牙开关状态
5. if (data === bluetooth.BluetoothState.STATE_ON) {
6. logger.info(TAG, `enter BluetoothState.STATE_ON`)
7. //蓝牙打开后的相关操作
8. this.foundDevices()
9. }
10. if (data === bluetooth.BluetoothState.STATE_OFF) {
11. logger.info(TAG, `enter BluetoothState.STATE_OFF`)
12. bluetooth.off('bluetoothDeviceFind', (data) => {
13. logger.info(TAG, `offBluetoothDeviceFindData = ${JSON.stringify(data)}`)
14. })
15. //关闭
16. bluetooth.stopBluetoothDiscovery()
17. this.discoveryList = []
18. }
19. logger.info(TAG, `BluetoothState = ${JSON.stringify(data)}`)
20. })
21. //开启蓝牙
22. bluetooth.enableBluetooth()
23. }
复制代码
设置蓝牙扫描模式并开启扫描去发现设备，并订阅蓝牙设备发现上报时间获取设备列表
1. foundDevices() {
2. //订阅蓝牙设备发现上报事件
3. bluetooth.on('bluetoothDeviceFind', (data) => {
4. logger.info(TAG, `enter on bluetoothDeviceFind`)
5. if (data !== null && data.length > 0) {
6. if (this.discoveryList.indexOf(data[0]) === -1 && this.deviceList.indexOf(data[0]) === -1) {
7. this.discoveryList.push(data[0])
8. }
9. logger.info(TAG, `discoveryList = ${JSON.stringify(this.discoveryList)}`)
10. }
11. let list = bluetooth.getPairedDevices()
12. if (list !== null && list.length > 0) {
13. this.deviceList = list
14. logger.info(TAG, `deviceList = ${JSON.stringify(this.deviceList)}`)
15. }
16. })
17. //开启蓝牙扫描，可以发现远端设备
18. bluetooth.startBluetoothDiscovery()
19. //设置蓝牙扫描模式，可以被远端设备发现
20. bluetooth.setBluetoothScanMode(bluetooth.ScanMode.SCAN_MODE_CONNECTABLE_GENERAL_DISCOVERABLE, TIME)
21. }
复制代码
设置蓝牙扫描模式并开启扫描去发现设备，并订阅蓝牙设备发现上报时间获取设备列表
1. //配对确定和取消代码在PinDialog.ets文件中
2. //setDevicePairingConfirmation(device: string, accept: boolean): void
3. //device string 表示远端设备地址，例如："XX:XX:XX:XX:XX:XX
4. //accept boolean 接受配对请求设置为true，否则设置为false
6. //订阅蓝牙配对状态改变事件，根据蓝牙状态更新设备列表
7. bluetooth.on('bondStateChange', (data) => {
8. logger.info(TAG, `enter bondStateChange`)
9. logger.info(TAG, `data = ${JSON.stringify(data)}`)
10. if (data.state === bluetooth.BondState.BOND_STATE_BONDED) {
11. logger.info(TAG, `BOND_STATE_BONDED`)
12. let index = this.discoveryList.indexOf(data.deviceId)
13. this.discoveryList.splice(index, 1)
14. this.deviceList = bluetooth.getPairedDevices()
15. }
16. if (data.state === bluetooth.BondState.BOND_STATE_INVALID) {
17. logger.info(TAG, `BOND_STATE_INVALID`)
18. this.deviceList = bluetooth.getPairedDevices()
19. }
20. logger.info(TAG, `bondStateChange,data = ${JSON.stringify(data)}`)
21. })
复制代码

最后

有很多小伙伴不知道学习哪些鸿蒙开辟技能？不知道需要重点掌握哪些鸿蒙应用开辟知识点？但是又不知道从那里下手，而且学习时频仍踩坑，终极浪费大量时间。以是本人整理了一些比较符合的鸿蒙（HarmonyOS NEXT）学习路径和一些资料的整理供小伙伴学习
点击领取→纯血鸿蒙Next全套最新学习资料（安全链接，放心点击）
希望这一份鸿蒙学习资料能够给大家带来资助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

一、鸿蒙（HarmonyOS NEXT）最新学习路线

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布条记整理收纳的一套体系性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开辟入门讲授视频，内容包含：（ArkTS、ArkUI开辟组件、Stage模型、多端部署、分布式应用开辟、音频、视频、WebGL、OpenHarmony多媒体技能、Napi组件、OpenHarmony内核、Harmony南向开辟、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）…等技能知识点。
获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料
二、HarmonyOS Next 最新全套视频教程