基于短距离通信的BLE蓝牙扫描

于 2024-07-09 15:03:24 发布
阅读量346 收藏 7
点赞数 3
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/hongxiaomeng/article/details/140296371
版权

场景描述

蓝牙是一种短距的无线通讯技术，可实现固定设备、移动设备之间的数据交换。一般将蓝牙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%')
  }
}

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

效果图

方案

相关接口能力：

  1. 开启蓝牙：access.enableBluetooth。
  2. 关闭蓝牙：access.disableBluetooth。
  3. 获取蓝牙配对列表：connection.getPairedDevices。
  4. 获取蓝牙配对状态：connection.getPairState。
  5. 订阅蓝牙设备发现上报事件：connection.on('bluetoothDeviceFind')。
  6. 取消订阅蓝牙设备发现上报事件：connection.off('bluetoothDeviceFind')。
  7. 开启蓝牙扫描，可以发现远端设备：connection.startBluetoothDiscovery。
  8. 关闭蓝牙扫描：connection.stopBluetoothDiscovery。
  9. 发起蓝牙配对：connection.pairDevice。
  10. 创建一个服务端监听Socket：socket.sppListen。

相关接口参考文档：@ohos.bluetooth.access (蓝牙access模块)，@ohos.bluetooth.connection (蓝牙connection模块)，@ohos.bluetooth.socket (蓝牙socket模块)。

核心代码

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);
    }
  })
}

 

hongxiaomeng
关注
  • 3
    点赞
  • 踩
  • 7
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
ble蓝牙通信，支持ble蓝牙搜索，连接，传输数据
12-10
支持ble蓝牙搜索，连接，传输数据，适用于连接蓝牙设备，用于蓝牙接口通信，内容比较庞大，可以获取蓝牙详细信息
ble-scanner:安卓 BLE 扫描仪
06-16
ble-scanner #说明 创建这个demo是因为在半年的时间里，两个Android项目都用到了BLE。所以我就开发的这个工具用来测试自己的项目。 虽然第一次负责的产品，在内部测试时提出了很多关于界面不简洁、操作不方便、使用对象不明确等问题。 但是对我来说，收获颇多。 产品认识 因为之前一直只是参与到一个系统部分功能的代码实现，没有机会从产品的需求设计到实现测试整个阶段的参与。 以前对于产品好坏的评定过多关注在技术上的完美，对于软件工程所讲的整个流程的重要性无法体会。 现在明白产品的成功是由需求调研、设计、推广、开发、测试、维护整个流程每一环节相互协作、共同努力实现的。 个人成长 此次实习经历让我更加了解自己，与单纯的技术钻研相比，我更喜欢探索用户的心理，思考产品的特性。 对于自己来说做产品比做开发要更适合。嘿嘿，是不是该笑我React太迟了，不过我的格言是“尝试、行动、尝试”。
Harmony os Next——Ble蓝牙模块
FranzLiszt的博客
06-02 966
本文将对Ble蓝牙模块的扫描、连接、订阅、发送指令等操作进行阐述。
OpenHarmony实战开发-蓝牙设置开发指导
m0_70749039的博客
05-13 829
蓝牙设置主要提供了开启蓝牙、关闭蓝牙、获取蓝牙状态的方法，帮助开发者实现基本蓝牙功能。
Harmony Ble 蓝牙App （一）扫描
晨曦
11-20 1040
关于Android的低功耗蓝牙，我做了很多介绍了，那么对于Harmony来说这一块我没有做过介绍，而实际中我确实做过一个Harmony的BLE项目，所以这里分享一些内容出来。//蓝牙设备真实名称//地址//信号强度//设备if (name!= null ||!这个Bean没有什么好说的，下面要做的就是列表Item的渲染，在Android中我们使用的是适配器Adapter，而在Harmony中使用的是提供者Provider。
蓝牙enable 失败问题
笔记
09-07 678
上电蓝牙芯片默认的波特率为115200，但是实际上蓝牙在正常工作的时候115200波特率满足不了通信速度，需要提升波特率。 曾经遇到过一款蓝牙芯片有一款没有CTS 管脚，但是在CPU这边已经配置启用了硬件流校验功能，导致蓝牙使能失败。 查看蓝牙log发现在115200时候CPU与蓝牙通信正常，提高波特率开始硬件流校验功能后一直等待不到蓝牙芯片反馈的数据导致使能失败，最后才知道蓝牙芯片没有CTS...
Android短距开发之蓝牙开发
看，好自为之的博客！！！
06-23 2069
Android蓝牙开发相关的内容和流程
OpenHarmony鸿蒙蓝牙BLE调试app
pjie131_的博客
05-09 610
OpenHarmony蓝牙模块提供了ble的功能，本篇提供一个简单的app供测试时使用。代码使用API10，对应4.0Release版本固件。
鸿蒙开发通信与连接：【@ohos.bluetooth (蓝牙)】
最新发布
2301_76813281的博客
06-19 826
version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
Android Ble蓝牙App（一）扫描
晨曦
07-31 5694
  关于低功耗的蓝牙介绍我已经做过很多了，只不过很多人不是奔着学习的目的去的，拿着源码就去运行，后面又发现连接设备后马上断开，然后不会自己看问题，这个现象就是快餐式的，你不了解里面的知识内容，自然就不知道是怎么回事，重复的问题我回答了好多次了。而我也是觉得写的有问题，本意上来说我是希望读者可以参考来写，能看一看文章内容，而结果绝大多数，看个标题看个运行效果，下载源码就运行，运行有问题就问你，没有什么思考。   针对这个情况，我决定做了系列性的Ble蓝牙App，尽可能的避免在你运行的时候出现bug，所以这是一
bledemo（扫描+连接）
05-25
一个android的bledemo，目前只有扫描和连接，如果要完整的通讯的demo的话，建议去下我的那个ble通信的demo，这个只是我写博客用的而已。
android beacon（当使用ble扫描设备时，使android手机可以被扫描到）
03-26
需android5.0及以上 android手机系统蓝牙广播是传统蓝牙的广播，此demo可以发送ble广播，使手机可以被ble扫描到
蓝牙扫描（经典蓝牙与Ble扫描）
09-03
自己写的代码，可以运行但是逻辑比较乱，可以看下我写的博客，希望可以帮助到你。
BLE蓝牙通信
04-13
BLE（Bluetooth Low Energy）蓝牙通信是一种低功耗、高效能的无线通信技术，主要用于物联网设备之间的短距离通信。它被广泛应用于可穿戴设备、智能家居、健康监测等场景，因为其低功耗特性使得电池寿命得以显著延长...
BLE蓝牙串口
05-22
蓝牙低功耗（Bluetooth Low Energy, 简称BLE或Bluetooth LE）是一种在物联网设备间进行通信的技术，尤其适用于需要长时间电池寿命和短距离无线连接的场景。它作为蓝牙技术联盟（SIG）推出的标准，旨在为物联网应用...
蓝牙BLE服务端+客户端.zip
10-10
1. BLE概述：BLE是为了满足物联网设备长时间工作的需求而设计的，它以更低的功耗实现了短距离数据传输。相比于传统蓝牙，BLE更加节能，适合大量传感器和可穿戴设备的通信场景。 2. Android BLE支持：Android系统从...
经典蓝牙+ble蓝牙（低功耗蓝牙）客户端\服务端开发
07-13
在IT行业中，蓝牙技术是一种广泛应用于无线通信的短距离传输技术，主要分为经典蓝牙和BLE（低功耗蓝牙）两种类型。本主题聚焦于这两种蓝牙技术的客户端和服务端开发，特别是针对Android平台。 经典蓝牙是一种早期的...
.net plugin.ble 蓝牙通信实例
06-20
蓝牙（Bluetooth）是一种无线通信技术，可用于短距离的数据传输。BLE（Bluetooth Low Energy）是一种低功耗的蓝牙技术，常用于智能设备之间的互联和传输。 在.NET应用程序中使用插件和BLE蓝牙通信可以实现许多功能...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值