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

最新推荐文章于 2024-08-05 14:50:46 发布
最新推荐文章于 2024-08-05 14:50:46 发布
阅读量353 收藏 8
点赞数 5
分类专栏： 鸿蒙开发 移动开发 HarmonyOS 文章标签： harmonyos 华为 移动开发 鸿蒙开发 ArkTS 蓝牙 信息与通信
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/MNXN666/article/details/140725799
版权
鸿蒙开发 同时被 3 个专栏收录
100 篇文章 3 订阅
订阅专栏
移动开发
100 篇文章 1 订阅
订阅专栏
HarmonyOS
100 篇文章 2 订阅
订阅专栏

场景描述

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

场景一：申请蓝牙权限

方案：

ACCESS_BLUETOOTH 权限是很多蓝牙接口需要申请的，比如：ble.getConnectedBLEDevices（获取和当前设备连接的BLE设备）、ble.startBLEScan（发起BLE扫描流程）。这个权限是需要用户授权的，可以通过调用requestPermissionsFromUser()方法来实现。

不鼓励频繁弹窗打扰用户，如果用户拒绝授权，将无法再次拉起弹窗。需要应用引导用户在系统应用“设置”的界面中手动授予权限。

核心代码

requestPermissionsFromUser() { 
  let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager(); 
  try { 
    let context = getContext(this); 
    atManager.requestPermissionsFromUser(context, ['ohos.permission.ACCESS_BLUETOOTH'], (err: BusinessError, data: PermissionRequestResult) => { 
      console.info('data:' + JSON.stringify(data)); 
      console.info('data permissions:' + data.permissions); 
      console.info('data authResults:' + data.authResults); 
    }); 
  } catch (err) { 
    console.log(`catch err->${JSON.stringify(err)}`); 
  } 
}

配置文件

module.json文件中申请相关权限，相关权限说明可参考文档：

"requestPermissions":[ 
  { 
    "name" : "ohos.permission.ACCESS_BLUETOOTH", 
    "reason": "$string:module_desc", 
    "usedScene": { 
      "abilities": [ 
        "FormAbility" 
      ], 
      "when":"always" 
    } 
  }, 
  { 
    "name" : "ohos.permission.DISCOVER_BLUETOOTH", 
    "usedScene": { 
      "abilities": [ 
        "FormAbility" 
      ], 
      "when":"always" 
    } 
  }, 
  { 
    "name" : "ohos.permission.USE_BLUETOOTH", 
    "usedScene": { 
      "abilities": [ 
        "bluetouth" 
      ], 
      "when":"always" 
    } 
  }, 
]

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

BLE为低功耗蓝牙，只能扫描到低功耗的蓝牙设备。

connection是经典蓝牙，如果想扫描到系统设置中的所有设备，可以调用此接口。

方案：

ble扫描的是低功耗蓝牙，相比于connection扫描结果偏少，如果想要扫描到系统设置中的所有设备，需要去调用@ohos.bluetooth.connection模块中的connection.startbluetoothdiscovery。

核心代码

低功耗蓝牙扫描：ble.startBLEScan

import { BusinessError } from '@kit.BasicServicesKit'; 
import { ble } from '@kit.ConnectivityKit'; 

@Entry 
@Component 
struct Index { 
  @State onReceiveEventData: string = '' 
  @State isScan: boolean = false 
  // ... 

  build() { 
    Row() { 
      Column() { 
        // 蓝牙扫描 
        Button("startBLEScan") 
          .onClick(() => { 
            this.isScan = !this.isScan 
            let onReceiveEvent = (data: Array<ble.ScanResult>) => { 
              console.info('BLE scan device find result = ' + JSON.stringify(data)); 
              let dataString = JSON.stringify(data) 
              this.onReceiveEventData = dataString 
            } 
            try { 
              ble.on("BLEDeviceFind", onReceiveEvent); 
              let scanFilter: ble.ScanFilter = { 
                // deviceId:"xxxx", 
                // name:"test", 
                // serviceUuid:"xxxx" 
              }; 
              console.info('scanFilter' + JSON.stringify(scanFilter)) 
              let scanOptions: ble.ScanOptions = { 
                interval: 50, 
                dutyMode: ble.ScanDuty.SCAN_MODE_LOW_POWER, 
                matchMode: ble.MatchMode.MATCH_MODE_AGGRESSIVE, 
              } 
              ble.startBLEScan(null, scanOptions); 
            } catch (err) { 
              console.error('errCode: ' + (err as BusinessError).code + ', errMessage: ' + 
              (err as BusinessError).message); 
            } 

          }) 
          .type(ButtonType.Capsule) 
          .margin({ top: 4 }) 
          .backgroundColor('#ff1198ee') 
          .width('67%') 
          .height('4%') 
        // ... 
        Text(this.isScan ? this.onReceiveEventData : '蓝牙未开启扫描') 
          .textAlign(TextAlign.Center) 
          .fontSize(12) 
          .border({ width: 1 }) 
          .padding(10) 
          .margin(10) 
          .width('80%') 
          .height(200) 
      } 
      .width('100%') 
    } 
    .height('100%') 
  } 
}

经典蓝牙扫描：connection.startBluetoothDiscovery。

import { BusinessError } from '@kit.BasicServicesKit'; 
import connection from '@ohos.bluetooth.connection'; 

@Entry 
@Component 
struct Index { 
  @State onReceiveEventData: string = '' 
  @State isScan: boolean = false 
  // ... 

  build() { 
    Row() { 
      Column() { 
        // 蓝牙扫描 
        Button("startBluetoothDiscovery") 
          .onClick(() => { 
            this.isScan = !this.isScan 
            let onReceiveEvent = (data: Array<string>) => { 
              console.log('data length' + JSON.stringify(data)); 
              let dataString = JSON.stringify(data) 
              this.onReceiveEventData = dataString 
            } 
            try { 
              connection.on('bluetoothDeviceFind', onReceiveEvent); 
              connection.startBluetoothDiscovery(); 
            } catch (err) { 
              console.error('errCode: ' + (err as BusinessError).code + ', errMessage: ' + 
              (err as BusinessError).message); 
            } 
          }) 
          .type(ButtonType.Capsule) 
          .margin({ top: 4 }) 
          .backgroundColor('#ff1198ee') 
          .width('67%') 
          .height('4%') 
        Text(this.isScan ? this.onReceiveEventData : '蓝牙未开启扫描') 
          .textAlign(TextAlign.Center) 
          .fontSize(12) 
          .border({ width: 1 }) 
          .padding(10) 
          .margin(10) 
          .width('80%') 
          .height(200) 
      } 
      .width('100%') 
    } 
    .height('100%') 
  } 
}

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

效果图

方案：

相关接口能力：

⦁    开启蓝牙：access.enableBluetooth。

⦁    关闭蓝牙：access.disableBluetooth。

⦁    获取蓝牙配对列表：connection.getPairedDevices。

⦁    获取蓝牙配对状态：connection.getPairState。

⦁    订阅蓝牙设备发现上报事件：connection.on(‘bluetoothDeviceFind’)。

⦁    取消订阅蓝牙设备发现上报事件：connection.off(‘bluetoothDeviceFind’)。

⦁    开启蓝牙扫描，可以发现远端设备：connection.startBluetoothDiscovery。

⦁    关闭蓝牙扫描：connection.stopBluetoothDiscovery。

⦁    发起蓝牙配对：connection.pairDevice。

⦁    创建一个服务端监听Socket：socket.sppListen。

核心代码

GridItem(){ 
  Button('打开权限').onClick(() => { 
    hilog.info(0x00000, TAG, '打开权限'); 
    this.requestPermissionsFromUser(); 
  }) 
} 
.columnStart(0) 
.columnEnd(1) 
.rowStart(0) 
.rowEnd(0) 

GridItem() { 
  Button('蓝牙-开启').onClick(() => { 
    hilog.info(0x00000, TAG, '蓝牙-开启'); 
    try { 
      access.enableBluetooth(); 
    } catch (err) { 
      hilog.info(0x00000, TAG, 'errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message); 
    } 
  }) 
} 

GridItem() { 
  Button('蓝牙-关闭').onClick(() => { 
    hilog.info(0x00000, TAG, '蓝牙-关闭'); 
    try { 
      access.disableBluetooth(); 
    } catch (err) { 
      hilog.info(0x00000, TAG, 'errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message); 
    } 
  }) 
} 

GridItem() { 
  Button('获取蓝牙配对列表&状态').onClick(() => { 
    hilog.info(0x00000, TAG, '获取蓝牙配对列表'); 
    try { 
      let result: Array<string> = connection.getPairedDevices(); 
      let index = 1; 
      result.forEach(s => { 
        let state = connection.getPairState(s) 
        hilog.info(0x00000, TAG, '第%{public}s台设备，id-> %{public}s,状态为->%{public}s', index++, s, bluetoothBondStateMap.get(state)); 
      }) 
    } catch (err) { 
      hilog.info(0x00000, TAG, 'errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message); 
    } 
  }) 
} 
.columnStart(0) 
.columnEnd(1) 
.rowStart(1) 
.rowEnd(1) 

GridItem() { 
  Button('订阅蓝牙设备发现上报事件').onClick(() => { 
    hilog.info(0x00000, TAG, '订阅蓝牙设备发现上报事件。'); 
    try { 
      connection.on('bluetoothDeviceFind', onReceiveEvent); 
    } catch (err) { 
      hilog.info(0x00000, TAG, 'errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message); 
    } 
  }) 
} 
.columnStart(0) 
.columnEnd(1) 
.rowStart(2) 
.rowEnd(2) 
GridItem() { 
  Button('取消订阅设备发现上报事件').onClick(() => { 
    hilog.info(0x00000, TAG, '取消订阅设备发现上报事件'); 
    try { 
      hilog.info(0x00000, TAG, '共发现了设备数量为-1#' + deviceSet.size); 
      connection.off('bluetoothDeviceFind', onReceiveEvent); 
      index = 1; 

    } catch (err) { 
      hilog.info(0x00000, TAG, 'errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message); 
    } 
  }) 
} 
.columnStart(0) 
.columnEnd(1) 
.rowStart(3) 
.rowEnd(3) 

GridItem() { 
  Button('蓝牙-开启扫描').onClick(() => { 
    hilog.info(0x00000, TAG, '蓝牙-开启扫描'); 
    try { 
      connection.startBluetoothDiscovery() 
    } catch (err) { 
      hilog.info(0x00000, TAG, 'errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message); 
    } 
  }) 
}

鸿蒙全栈开发全新学习指南

之前总有很多小伙伴向我反馈说，不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以这里为大家准备了一份实用的鸿蒙（HarmonyOS NEXT）学习路线与学习文档用来跟着学习是非常有必要的。

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

本路线共分为四个阶段：

第一阶段：鸿蒙初中级开发必备技能

在这里插入图片描述

第二阶段：鸿蒙南北双向高工技能基础：gitee.com/MNxiaona/733GH

在这里插入图片描述

第三阶段：应用开发中高级就业技术

第四阶段：全网首发-工业级南向设备开发就业技术：gitee.com/MNxiaona/733GH

在这里插入图片描述

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

如何快速入门？

1.基本概念
2.构建第一个ArkTS应用
3.……

开发基础知识:gitee.com/MNxiaona/733GH

1.应用基础知识
2.配置文件
3.应用数据管理
4.应用安全管理
5.应用隐私保护
6.三方应用调用管控机制
7.资源分类与访问
8.学习ArkTS语言
9.……

在这里插入图片描述

基于ArkTS 开发

1.Ability开发
2.UI开发
3.公共事件与通知
4.窗口管理
5.媒体
6.安全
7.网络与链接
8.电话服务
9.数据管理
10.后台任务(Background Task)管理
11.设备管理
12.设备使用信息统计
13.DFX
14.国际化开发
15.折叠屏系列
16.……

在这里插入图片描述

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

在这里插入图片描述

鸿蒙入门教学视频：

美团APP实战开发教学：gitee.com/MNxiaona/733GH

写在最后

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

「已注销」
关注
  • 5
    点赞
  • 踩
  • 8
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
HarmonyOS鸿蒙基于Java开发: 蓝牙开发
sybh的博客
01-15 1233
传统蓝牙本机管理主要是针对蓝牙本机的基本操作，包括打开和关闭蓝牙、设置和获取本机蓝牙名称、扫描和取消扫描周边蓝牙设备、获取本机蓝牙profile对其他设备的连接状态、获取本机蓝牙已配对的蓝牙设备列表。传统蓝牙远端管理操作主要是针对远端蓝牙设备的基本操作，包括获取远端蓝牙设备地址、类型、名称和配对状态，以及向远端设备发起配对。通过BLE扫描和广播提供的开放能力，可以根据指定状态获取外围设备、启动或停止BLE扫描、广播。
BLE蓝牙4.0开发完全手册-物联网开发技术实战.pdf
07-03
蓝牙BLE4.0开发完全手册 物联网开发技术实战
基于短距离通信的BLE蓝牙扫描
hongxiaomeng的博客
07-09 365
鸿蒙开发通信与连接：【@ohos.bluetooth (蓝牙)】
2301_76813281的博客
06-19 1015
version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
Harmony os Next——Ble蓝牙模块
FranzLiszt的博客
06-02 1121
本文将对Ble蓝牙模块的扫描、连接、订阅、发送指令等操作进行阐述。
鸿蒙Harmony开发案例教程：如何进行蓝牙设备发现、配对、取消配对功能
m0_64422261的博客
06-27 1439
为固定和移动设备建立通信环境的一种特殊的连接。
Android BLE开发之Android手机与BLE终端通信 程序文件
04-21
最近穿戴设备发展得很火，把相关技术也带旺了，其中一项是BLE（Bluetooth Low Energy）。BLE是蓝牙4.0的核心Profile，主打功能是快速搜索，快速连接，超低...PS：我的i9100刷了4.4系统后，竟然也能跟BLE蓝牙模块通信。
windows visual studio C++ 蓝牙BLE客户端(蓝牙调试工具)的完整源码和例子，可用于调试蓝牙BLE的开发
04-12
BLE技术是蓝牙技术的一个分支，旨在实现低功耗、短距离的无线通信。它特别适合于物联网（IoT）设备和移动设备之间的通信，如健康监测设备、智能家居产品等。BLE协议栈包括了广告、连接、服务发现、数据传输等一系列...
HC-08 蓝牙串口通信模块是新一代的基于 Bluetooth Specification V4.0 BLE 蓝牙协议的数传模块
06-23
HC-08 蓝牙串口通信模块是新一代的基于 Bluetooth Specification V4.0 BLE 蓝牙协议的数传模块。无线工作频段为 2.4GHz ISM，调制方式是 GFSK。模块最大发射功率为 4dBm，接收灵敏度-93dBm，空旷环境下和 iphone4s ...
Android短距开发之蓝牙开发
看，好自为之的博客！！！
06-23 2254
Android蓝牙开发相关的内容和流程
ble-scanner:安卓 BLE 扫描仪
06-16
ble-scanner #说明 创建这个demo是因为在半年的时间里，两个Android项目都用到了BLE。所以我就开发的这个工具用来测试自己的项目。 虽然第一次负责的产品，在内部测试时提出了很多关于界面不简洁、操作不方便、使用对象不明确等问题。 但是对我来说，收获颇多。 产品认识 因为之前一直只是参与到一个系统部分功能的代码实现，没有机会从产品的需求设计到实现测试整个阶段的参与。 以前对于产品好坏的评定过多关注在技术上的完美，对于软件工程所讲的整个流程的重要性无法体会。 现在明白产品的成功是由需求调研、设计、推广、开发、测试、维护整个流程每一环节相互协作、共同努力实现的。 个人成长 此次实习经历让我更加了解自己，与单纯的技术钻研相比，我更喜欢探索用户的心理，思考产品的特性。 对于自己来说做产品比做开发要更适合。嘿嘿，是不是该笑我React太迟了，不过我的格言是“尝试、行动、尝试”。
bledemo（扫描+连接）
05-25
一个android的bledemo，目前只有扫描和连接，如果要完整的通讯的demo的话，建议去下我的那个ble通信的demo，这个只是我写博客用的而已。
android beacon（当使用ble扫描设备时，使android手机可以被扫描到）
03-26
需android5.0及以上 android手机系统蓝牙广播是传统蓝牙的广播，此demo可以发送ble广播，使手机可以被ble扫描到
【鸿蒙南向开发】浅谈OpenHarmony蓝牙模块
最新发布
HarmonyOS_666的博客
08-05 898
​ 蓝牙是一种支持设备短距离通信（一般10m内）的无线电技术，能在包括移动电话、PDA、无线耳机、笔记本电脑、相关外设等众多具有蓝牙模块的设备之间进行短距离无线信息交换，使得数据传输变得更加迅速高效。它是爱立信、IBM等5家公司在1998年联合推出的一项无线通信技术，随后成立的蓝牙技术特殊兴趣组织（SIG）来负责该技术的开发和技术协议的制定，如今全世界已有1800多家公司加盟该组织。​ 蓝牙工作在全球通用的2.4GHz ISM（即工业、科学、医学）频段，使用IEEE802.15协议。
OpenHarmony鸿蒙蓝牙BLE调试app
pjie131_的博客
05-09 683
OpenHarmony蓝牙模块提供了ble的功能，本篇提供一个简单的app供测试时使用。代码使用API10，对应4.0Release版本固件。
Android Ble蓝牙App（一）扫描
晨曦
07-31 5919
  关于低功耗的蓝牙介绍我已经做过很多了，只不过很多人不是奔着学习的目的去的，拿着源码就去运行，后面又发现连接设备后马上断开，然后不会自己看问题，这个现象就是快餐式的，你不了解里面的知识内容，自然就不知道是怎么回事，重复的问题我回答了好多次了。而我也是觉得写的有问题，本意上来说我是希望读者可以参考来写，能看一看文章内容，而结果绝大多数，看个标题看个运行效果，下载源码就运行，运行有问题就问你，没有什么思考。   针对这个情况，我决定做了系列性的Ble蓝牙App，尽可能的避免在你运行的时候出现bug，所以这是一
Android BLE 扫描 通信
jeesia的博客
04-03 1293
Android 设备扫描 低功耗蓝牙（BLE）设备，通信 (蓝牙4.0)
鸿蒙开发之【蓝牙HCI与蓝牙hld】
2301_76813281的博客
01-30 1080
蓝牙的命名来源于一个丹麦国王的名字。蓝牙的核心是短距离无线电通讯，它的基础来自于跳频扩频（FHSS）技术。频率：[2.4GHz, 2.4GHz + 83.5MHz]物联网领域需要研究Bluetooth + Mesh。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值