HarmonyOS开发实战（ Beta5.0）蓝牙实现服务端和客户端通讯详解

让开，我要吃人了2024-09-13 11:47

鸿蒙HarmonyOS开发往期必看：

HarmonyOS NEXT应用开发性能实践总结

最新版！"非常详细的" 鸿蒙HarmonyOS Next应用开发学习路线！（从零基础入门到精通）

介绍

本示例分为服务端和客户端两个功能模块。

服务端创建蓝牙服务实例，添加心率跳动服务。以心率跳动值作为特征值，通过notifyCharacteristicChanged接口将心率跳动特征值广播发送给连接到本服务端并订阅了该特征值变动通知的蓝牙客户端设备。

客户端以特定服务UUID作为过滤条件扫描服务端，连接到扫描的设备后通过setCharacteristicChangeNotification接口向服务端发送'通知心率跳动特征值变动'的请求，以便收到服务端该特征值变动的通知消息。

主要有以下几点功能：

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

相关概念：

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

效果图预览

使用说明

  1. 该功能需要两台设备，进入BLE通讯场景页面，选择当前设备是作为BLE服务端还是BLE客户端。
  2. 点击"BLE服务端"，进入服务端页面。点击"开启BLE心率广播"，打开蓝牙服务，向订阅了心率跳动值通知的客户端广播发送实时心率值。
  3. 点击"BLE客户端"，进入客户端页面。点击"搜索设备"，搜索开启了心率跳动服务的BLE服务端，连接搜索到的蓝牙设备。连接成功后，点击设备右边的"已连接"，进入心率波动图页面查看实时心率。

实现思路

服务端

  1. 开启或关闭蓝牙广播服务。源码参考BluetoothAdvertiser.ets及startAdvertiser。

    toggleAdvertiser(): void {
 if (this.startAdvertiserState) {
   //  TODO: 知识点 关闭蓝牙广播服务
   advertiserBluetoothViewModel.stopAdvertiser();
   this.toggleHeartRate(false);
   this.startAdvertiserState = false;
 } else {
   //  TODO: 知识点 开启蓝牙广播服务
   let ret = advertiserBluetoothViewModel.startAdvertiser();
   if (ret) {
     this.localName = advertiserBluetoothViewModel.getLocalName();
     // 模拟心率跳动
     this.toggleHeartRate(true);
     this.startAdvertiserState = true;
   } else {
     Log.showError(TAG, `toggleAdvertiser: ret = ${ret}`);
   }
 }
}

 // TODO: 知识点 创建蓝牙服务实例
 this.mGattServer = ble.createGattServer();

 let descriptors: Array<ble.BLEDescriptor> = [];
 const arrayBuffer = ArrayBufferUtils.byteArray2ArrayBuffer([11]);
 const descriptor: ble.BLEDescriptor = {
   serviceUuid: BleConstants.UUID_SERVICE_HEART_RATE, //  特定服务（service）的 UUID
   characteristicUuid: BleConstants.UUID_CHARACTERISTIC_HEART_RATE_MEASUREMENT, // 特定特征（characteristic）的 UUID
   descriptorUuid: BleConstants.UUID_DESCRIPTOR_HEART_RATE, // 描述符（descriptor）的 UUID
   descriptorValue: arrayBuffer  // 描述符对应的二进制值
 };
 descriptors[0] = descriptor;

 let characteristics: Array<ble.BLECharacteristic> = [];
 const arrayBufferC = ArrayBufferUtils.byteArray2ArrayBuffer([1]);
 const characteristic: ble.BLECharacteristic = {
   serviceUuid: BleConstants.UUID_SERVICE_HEART_RATE, // 特定服务（service）的 UUID
   characteristicUuid: BleConstants.UUID_CHARACTERISTIC_HEART_RATE_MEASUREMENT, // 特定特征（characteristic）的 UUID
   characteristicValue: arrayBufferC, // 特征对应的二进制值
   descriptors: descriptors  // 特定特征的描述符列表
 };
 characteristics[0] = characteristic;
 // 定义心率跳动服务
 const service: ble.GattService = {
   serviceUuid: BleConstants.UUID_SERVICE_HEART_RATE,
   isPrimary: true, // 主服务
   characteristics: characteristics,
   includeServices: []
 };

 try {
   // 添加服务
   this.mGattServer.addService(service);
   Log.showInfo(TAG, `startAdvertiser: addService suc`);
 } catch (err) {
   Log.showError(TAG, `startAdvertiser: addService err = ${err}`);
 }

 try {
   // 订阅连接服务状态
   this.onConnectStateChange();

   // 设置广播发送的参数
   let setting: ble.AdvertiseSetting = {
     interval: DurationConstants.ADVERTISE_INTERVAL, // 广播间隔，最小值设置160个slot表示100ms
     txPower: 1, // 发送功率，最小值设置-127，最大值设置1，默认值设置-7
     connectable: true  // 是否是可连接广播
   };
   // BLE广播包内容
   let advData: ble.AdvertiseData = {
     serviceUuids: [BleConstants.UUID_SERVICE_HEART_RATE], // 要广播的服务 UUID 列表
     manufactureData: [], // 广播的制造商信息列表
     serviceData: [], // 广播的服务数据列表
   };
   // BLE回复扫描请求回复响应
   let advResponse: ble.AdvertiseData = {
     serviceUuids: [BleConstants.UUID_SERVICE_HEART_RATE],
     manufactureData: [],
     serviceData: [],
   };
   // TODO: 知识点 开始广播
   ble.startAdvertising(setting, advData, advResponse);
   Log.showInfo(TAG, `startAdvertiser: startAdvertising success`);
   return true;
 } catch (err) {
   Log.showError(TAG, `startAdvertiser: startAdvertising err = ${err}`);
 }

  2. 服务开启状态下，广播通知特征值变动。源码参考BluetoothAdvertiser.ets及notifyCharacteristicChanged。

       this.mIntervalId = setInterval(() => {
     this.heartRate = MathUtils.getRandomInt(MIN_HEART_RATE, MAX_HEART_RATE);
     if (this.deviceId) {
       // TODO: 知识点 通知客户端心率特征值变动
       advertiserBluetoothViewModel.notifyCharacteristicChanged(this.deviceId, this.heartRate);
     } else {
       Log.showWarn(TAG, `toggleHeartRate: deviceId is null， heartRate = ${this.heartRate}`);
     }
   }, DurationConstants.NOTIFY_DELAY_TIME)

     // 构造BLECharacteristic
     let arrayBufferC = ArrayBufferUtils.byteArray2ArrayBuffer([0x00, heartRate]);
     let characteristic: CharacteristicModel = {
       serviceUuid: BleConstants.UUID_SERVICE_HEART_RATE,
       characteristicUuid: BleConstants.UUID_CHARACTERISTIC_HEART_RATE_MEASUREMENT,
       characteristicValue: arrayBufferC,
       descriptors: descriptors
     };
     // 通知的特征值消息
     let notifyCharacteristic: NotifyCharacteristicModel = {
       serviceUuid: BleConstants.UUID_SERVICE_HEART_RATE,
       characteristicUuid: BleConstants.UUID_CHARACTERISTIC_HEART_RATE_MEASUREMENT,
       characteristicValue: characteristic.characteristicValue,
       confirm: false  // 对端不需要确认
     };
     // TODO: 知识点 server端特征值发生变化时，主动通知已连接的client设备。
     this.mGattServer.notifyCharacteristicChanged(deviceId, notifyCharacteristic, (err: BusinessError) => {
       if (err) {
         Log.showError(TAG, 'notifyCharacteristicChanged callback failed， err.code = ' + err.code + ", err.message =" + err.message);
       } else {
         Log.showInfo(TAG, 'notifyCharacteristicChanged callback success');
       }
     });
客户端

  1. 启动时请求蓝牙权限。源码参考BluetoothClient.ets。

    // 所需蓝牙权限
const PERMISSION_LIST: Array<Permissions> = [
  'ohos.permission.APPROXIMATELY_LOCATION',
  'ohos.permission.LOCATION'
];

// TODO 知识点： 获取蓝牙相关权限
function reqPermissionsFromUser(permissions: Array<Permissions>, context: common.UIAbilityContext): void {
  const atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
  atManager.requestPermissionsFromUser(context, permissions).then((data) => {
    const granStatus: Array<number> = data.authResults;
    const length: number = granStatus.length;
    for (let i = 0; i < length; i++) {
      if (granStatus[i] === 0) {

      } else {
        return;
      }
    }
  })
}

  2. 扫描设备。源码参考BluetoothClientModel.ets

    startBLEScan(): boolean {   
  if (!this.isBluetoothEnabled()) {
    Log.showInfo(TAG, `startBLEScan: bluetooth is disable.`);
    // 启动蓝牙服务
    this.enableBluetooth();
    promptAction.showToast({
      message: $r('app.string.ble_toast_enable_bluetooth'),
        duration: DurationConstants.DURATION_TIME
      });
    return false;
  }
  // 订阅搜索蓝牙服务
  this.onBLEDeviceFind(); 
  // 扫描蓝牙设备
  const ret = this.startBLEScanInner();
  return ret;
}

  3. 连接设备。源码参考BluetoothClientModel.ets及connectInner。

    .onClick(() => {
  if (this.bluetoothDevice.connectionState === ConnectionState.STATE_DISCONNECTED) {
    // 连接蓝牙设备
    bluetoothViewModel.connect(this.bluetoothDevice);
  } else if (this.bluetoothDevice.connectionState === ConnectionState.STATE_CONNECTED) { 
    // 断开与蓝牙设备的连接
    bluetoothViewModel.disconnect();
  }
})

private connectInner(gattClientDevice: ble.GattClientDevice): boolean {
  try {
    if (!gattClientDevice) {
      Log.showWarn(TAG, `connectInner: mGattClientDevice is null`);
      return false;
    }
    // 订阅连接状态改变消息
    this.onBLEConnectionStateChange();
    // 订阅特征值改变消息
    this.onBLECharacteristicChange();
    // 开始连接
    gattClientDevice.connect();
    this.mConnectBluetoothDevice.connectionState = ConnectionState.STATE_CONNECTING;
    AppStorage.setOrCreate('connectBluetoothDevice', this.mConnectBluetoothDevice);
    return true;
  } catch (err) {
    Log.showError(TAG, `connectInner: err = ${err}`);
  }
  return false;
}

  4. 向服务端发送'通知心率跳动'特征值请求,侦听特征值变化数据。源码参考BLECharacteristicChange。

    // connect success, Starts discovering services.
let services: Array<ble.GattService> = await this.mGattClientDevice!.getServices();
Log.showInfo(TAG, `onBLEConnectionStateChange: services = ${JSON.stringify(services)}`);

// Characteristic enable/disable indicate/notify
let service: ble.GattService | undefined =
services.find(item => item.serviceUuid === BleConstants.UUID_SERVICE_HEART_RATE);
let characteristics: Array<ble.BLECharacteristic> = service!.characteristics;
let characteristic: ble.BLECharacteristic | undefined =
characteristics.find(item => item.characteristicUuid ===
BleConstants.UUID_CHARACTERISTIC_HEART_RATE_MEASUREMENT);
Log.showInfo(TAG, `onBLEConnectionStateChange: characteristic = ${JSON.stringify(characteristic)}`);
// TODO 知识点： 向服务端发送设置通知此特征值请求
this.mGattClientDevice!.setCharacteristicChangeNotification(characteristic, true);
let descriptors: Array<ble.BLEDescriptor> = characteristic!.descriptors;
let descriptor: ble.BLEDescriptor | undefined =
descriptors.find(item => item.descriptorUuid === BleConstants.UUID_DESCRIPTOR_HEART_RATE);
Log.showInfo(TAG, `onBLEConnectionStateChange: descriptor = ${JSON.stringify(descriptor)}`);
descriptor!.descriptorValue = ArrayBufferUtils.byteArray2ArrayBuffer([0x01, 0x00]);
this.mGattClientDevice!.writeDescriptorValue(descriptor);

// TODO 知识点： 订阅特征值变化事件
this.mGattClientDevice.on('BLECharacteristicChange', (data: ble.BLECharacteristic) => {
Log.showInfo(TAG, `onBLECharacteristicChange: data = ${JSON.stringify(data)}`);
let characteristicValue: ArrayBuffer = data.characteristicValue;
Log.showInfo(TAG,
`onBLECharacteristicChange: characteristicValue.length = ${characteristicValue.byteLength}, characteristicValue = ${JSON.stringify(new Uint8Array(characteristicValue))}`);
let byteArr = ArrayBufferUtils.arrayBuffer2ByteArray(characteristicValue);
Log.showInfo(TAG, `byteArr = ${byteArr}`);
let heartRate = byteArr[1];
AppStorage.setOrCreate('heartRate', heartRate);
})

高性能知识点

不涉及

工程结构&模块类型

bluetooth                                  // har类型
src/main/ets/
|---constants
|   |---BleConstants.ts                    // BLE常量
|   |---StyleConstants.ts                  // Style样式常量
|   |---DurationConstants.ts.ts            // 定时、延迟类常量
|---model
|   |---BluetoothDevice.ets                // 蓝牙设备model
|---pages
|   |---BluetoothView.ets                  // 场景首页，可选择进入客户端、服务端
|   |---BluetoothAdvertiser.ets            // 广播者角色（作为服务端）
|   |---BluetoothClient.ets                // 客户端连接页面
|   |---HeartRate.ets                      // 连接成功后，侦听到服务端的心率数据   
|---uicomponents
|   |---HeartRateGraph.ets                 // 实时心率图表
|   |---NavigationBar.ets                  // 顶部导航栏
|---uitls
|   |---ArrayBufferUtils.ts                // ArrayBuffer工具
|   |---DateUtils.ts                       // 日期工具
|   |---Log.ts                             // 日志工具
|   |---MathUtils.ts                       // Math工具，用于生成随机数
|---viewmodel
|   |---BluetoothClientModel.ets           // 开启蓝牙、扫描BLE、连接、断连等BLE接口
|   |---AdvertiserBluetoothViewModel.ets   // 开启蓝牙、开启蓝牙心率广播等

最后

小编在之前的鸿蒙系统扫盲中，有很多朋友给我留言，不同的角度的问了一些问题，我明显感觉到一点，那就是许多人参与鸿蒙开发，但是又不知道从哪里下手，因为体系杂乱无章，教授的人也多，无从选择。有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）路线、视频、文档用来跟着学习是非常有必要的。

如果你是一名有经验的资深Android移动开发、Java开发、前端开发、对鸿蒙感兴趣以及转行人员

鸿蒙 NEXT 全栈开发学习笔记希望这一份鸿蒙学习文档能够给大家带来帮助~

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

​

该路线图包含基础技能、就业必备技能、多媒体技术、六大电商APP、进阶高级技能、实战就业级设备开发，不仅补充了华为官网未涉及的解决方案

路线图适合人群：

IT开发人员： 想要拓展职业边界
零基础小白： 鸿蒙爱好者，希望从0到1学习，增加一项技能。
**技术提升/进阶跳槽：**发展瓶颈期，提升职场竞争力，快速掌握鸿蒙技术

2.视频教程+学习PDF文档

（鸿蒙语法ArkTS、TypeScript、ArkUI教程......）

纯血版鸿蒙全套学习文档（面试、文档、全套视频等）

总结

参与鸿蒙开发，你要先认清适合你的方向，如果是想从事鸿蒙应用开发方向的话，可以参考本文的学习路径，简单来说就是：为了确保高效学习，建议规划清晰的学习路线

相关推荐
魔道不误砍柴功1 分钟前
Java 中如何巧妙应用 Function 让方法复用性更强
java·开发语言·python
闲晨4 分钟前
C++ 继承：代码传承的魔法棒，开启奇幻编程之旅
java·c语言·开发语言·c++·经验分享
老猿讲编程32 分钟前
一个例子来说明Ada语言的实时性支持
开发语言·ada
王哈哈^_^1 小时前
【数据集】【YOLO】【目标检测】交通事故识别数据集 8939 张，YOLO道路事故目标检测实战训练教程！
前端·人工智能·深度学习·yolo·目标检测·计算机视觉·pyqt
Chrikk1 小时前
Go-性能调优实战案例
开发语言·后端·golang
幼儿园老大*2 小时前
Go的环境搭建以及GoLand安装教程
开发语言·经验分享·后端·golang·go
canyuemanyue2 小时前
go语言连续监控事件并回调处理
开发语言·后端·golang
杜杜的man2 小时前
【go从零单排】go语言中的指针
开发语言·后端·golang
cs_dn_Jie2 小时前
钉钉 H5 微应用 手机端调试
前端·javascript·vue.js·vue·钉钉
开心工作室_kaic2 小时前
ssm068海鲜自助餐厅系统+vue(论文+源码)_kaic
前端·javascript·vue.js
热门推荐
01如何才能让手机厂商主动拥抱华为，接入鸿蒙系统？02【HarmonyOS】HUAWEI DevEco Studio 下载地址汇总03组基轨迹建模 GBTM的介绍与实现（Stata 或 R）04Macbook pro M1 安装Ubuntu教程05基于YOLOv10深度学习的CT扫描图像肾结石智能检测系统【python源码+Pyqt5界面+数据集+训练代码】深度学习实战、目标检测06【经验分享】Ubuntu22.04安装微信(linux官方版)07文件或文件夹名称中有空格如何批量去除08RAG 实践- Ollama+RagFlow 部署本地知识库09Windows10安装PCL1.14.0及点云配准10【TC3xx芯片】TC3xx芯片电源管理系统PMS详解