OpenHarmony 蓝牙相关API用法

介绍

本示例通过使用蓝牙低功耗心率服务，展示蓝牙相关API用法。实现了以下几点功能：

1. 发现具有特定服务的设备。
2. 连接到设备。
3. 发现服务。
4. 发现服务的特征、如何读取给定特征的值、为特征设置通知等。

相关概念

1. BLE扫描：通过BLE扫描接口实现对BLE设备的搜索。
2. BLE连接：通过BLE的GattClientDevice实现对BLE设备的连接、断连等操作。
3. 接收数据：通过BLECharacteristicChange接收特征值的改变。

效果预览

使用说明

1. 启动应用后，弹出是否允许应用访问位置信息，点击允许后开始操作。
2. 点击界面中搜索设备，如未开启蓝牙会自动开启并搜索心率设备，如已开启直接搜索设备。
3. 点击连接按钮可以连接到对应的蓝牙心率设备。
4. 点击列表Item可以进入实时心率图查看页面。
5. 点击实时心率图页断开连接可以断开与当前心率设备的连接。

工程目录

entry/src/main/ets/
|---constants
|   |---BleConstants.ts                    // BLE常量
|   |---StyleConstants.ts                  // Style样式常量
|---entryability
|---model
|   |---BluetoothDevice.ets                // 蓝牙设备model
|---pages
|   |---Main.ets                           // 首页
|   |---HeartRate.ets                      // 实时心率图
|---uicomponents
|   |---HeartRateGraph.ets                 // 实时心率图表
|   |---NavigationBar.ets                  // 顶部导航栏
|---uitls
|   |---ArrayBufferUtils.ts                // ArrayBuffer工具
|   |---DateUtils.ts                       // 日期工具
|   |---Log.ts                             // 日志工具
|---viewmodel
|   |---BluetoothViewModel.ets             // 主要封装了蓝牙库相关的接口，实现相关功能，如：开启蓝牙、扫描BLE、连接、断连等功能
advertiser/src/main/ets/
|---constants
|   |---BleConstants.ts                    // BLE常量
|---entryability
|---pages
|   |---Main.ets                           // 首页
|---uitls
|   |---ArrayBufferUtils.ts                // ArrayBuffer工具
|   |---Log.ts                             // 日志工具
|   |---MathUtils.ts                       // Math工具，用于生成随机数
|---viewmodel
|   |---AdvertiserBluetoothViewModel.ets   // 主要封装了蓝牙库相关的接口，实现相关功能，如：开启蓝牙、开启蓝牙心率广播等功能

具体实现

1. 首页扫描蓝牙心率设备：使用 bluetooth 来实现蓝牙的开启和BLE的扫描，然后再使用一个List显示扫描到BLE心率设备，点击连接按钮可以连接上对应的心率设备。
2. 实时心率图页：使用 bluetooth 来接收心率设备发送的心率数据，并使用画布 Canvas 来绘制实时心率图，点击断开连接可以断开与当前心率设备的连接。

相关权限

依赖

本示例需要使用设备来模拟BLE心率设备。这里使用OpenHarmony来模拟了BLE心率设备，相关代码在module - advertiser。使用另一台OpenHarmony设备运行advertiser编译出来的hap后，点击开启BLE心率广播。当BLE心率服务应用扫描并连接到模拟的BLE心率设备后，就可以在应用中查看当前模拟的实时心率。

约束与限制

1. 本示例仅支持标准系统上运行。
2. 本示例为Stage模型，从API version 9开始支持。SDK版本号：3.2.12.1 Release，镜像版本号：OpenHarmony 3.2.12.2。
3. 本示例需要使用DevEco Studio 3.1 Release (Build Version: 3.1.0.500, built on April 28, 2023)编译运行。
4. 本示例所配置的权限包含system_basic级别，需要手动配置对应级别的权限签名或者使用ACL使能。

下载

如需单独下载本工程，执行如下命令：

git init
git config core.sparsecheckout true
echo code/BasicFeature/Connectivity/Bluetooth/ > .git/info/sparse-checkout
git remote add origin https://gitee.com/openharmony/applications_app_samples.git
git pull origin master

最后

总是有很多小伙伴反馈说：鸿蒙开发不知道学习哪些技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？ 为了解决大家这些学习烦恼。在这准备了一份很实用的鸿蒙（HarmonyOS NEXT）学习路线与学习文档给大家用来跟着学习。

针对一些列因素，整理了一套纯血版鸿蒙（HarmonyOS Next）全栈开发技术的学习路线，包含了鸿蒙开发必掌握的核心知识要点，内容有（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、WebGL、元服务、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony驱动开发、系统定制移植等等）鸿蒙（HarmonyOS NEXT）技术知识点。

《鸿蒙 (Harmony OS)开发学习手册》（共计892页）

如何快速入门？

1.基本概念

2.构建第一个ArkTS应用

3.……

开发基础知识: https://gitee.com/MNxiaona/733GH/blob/master/qita.md

1.应用基础知识

2.配置文件

3.应用数据管理

4.应用安全管理

5.应用隐私保护

6.三方应用调用管控机制

7.资源分类与访问

8.学习ArkTS语言

9.……

鸿蒙开发面试真题（含参考答案）: https://gitee.com/MNxiaona/733GH/blob/master/qita.md

《OpenHarmony源码解析》

搭建开发环境

系统架构分析

• 构建子系统
• 启动流程
• 子系统
• 分布式任务调度子系统
• 分布式通信子系统
• 驱动子系统
• ……

OpenHarmony 设备开发学习手册: https://gitee.com/MNxiaona/733GH/blob/master/qita.md

写在最后

• 如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我三个小忙：
• 点赞，转发，有你们的 『点赞和评论』，才是我创造的动力。
• 关注小编，同时可以期待后续文章ing🚀，不定期分享原创知识。
• 想要获取更多完整鸿蒙最新学习资源，请移步前往小编: https://gitee.com/MNxiaona/733GH/blob/master/qita.md