HarmonyOS鸿蒙Next中如何获取BEACON_UUID

【问题描述】

在 HarmonyOS 进行 BLE 扫描时，期望根据 iBeacon 的 BEACON_UUID 对广播设备进行过滤。但在查看官方文档后，发现：

ble.ScanFilter 中只有 manufactureId、manufactureData、manufactureDataMask 三个字段
没有提供 BEACON_UUID 相关字段

导致无法直接根据 Beacon UUID 进行过滤。需确认是否支持 Beacon UUID 筛选，以及应该如何获取与过滤 iBeacon 的 UUID。

【问题现象】

在 API 文档中找不到 BEACON_UUID 字段
BLE 扫描未能根据 UUID 进行过滤
只能收到全部 BLE 广播数据，无法直接筛选目标 Beacon

【版本信息】：未涉及

【复现代码】：未涉及

【尝试解决方案】：未涉及

更多关于HarmonyOS鸿蒙Next中如何获取BEACON_UUID的实战教程也可以访问 https://www.itying.com/category-93-b0.html

wuwangju 1楼

可以通过 manufacturerId（0x004C）+ manufactureData + manufactureDataMask 来过滤特定 iBeacon 的广播数据。iBeacon 的 UUID 实际存放在广播包的 Manufacturer Data 中，而不是通过独立字段提供，因此鸿蒙无法直接按 UUID 过滤，只能依赖 Manufacturer Data。代码中的 manufactureData 填入了目标 UUID 对应的字节，而 manufactureDataMask 用 0xFF 标记需要精确匹配的 UUID 字节、用 0x00 忽略不需要比较的部分。这样系统在扫描时会自动比对广播包中的 Manufacturer Data，只返回 UUID 与目标值一致的 iBeacon 设备，从而实现“按 Beacon UUID 过滤扫描”的效果。

更多关于HarmonyOS鸿蒙Next中如何获取BEACON_UUID的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html

h691938207 2楼作者

iBeacon 广播包的 manufacturerData 包含固定格式数据：

| 厂商ID（2字节） | iBeacon标识（2字节） | UUID（16字节） | Major（2字节） | Minor（2字节） | 校准值（1字节） | | 0x004C | 0x02 0x15 | 例如：B9407F30-F5F8-466E-AFF9-25556B57FE6D | … | … | … |

HarmonyOS BLE 的 ScanFilter 仅支持通过 manufacturerId 和 manufacturerData 进行过滤，因此需要：

设置 manufacturerId=0x004C（Apple 公司标识）
解析扫描结果中的 manufacturerData 提取 UUID

songsunli 3楼

在HarmonyOS Next中获取BEACON_UUID需使用@ohos.bluetooth.manager模块。通过bluetoothManager.BLE类调用startBLEScan()方法扫描设备，在onBLEDeviceFind回调中获取扫描结果。设备信息对象包含scanRecord字段，解析该字段中的ManufactureData或ServiceData即可提取BEACON_UUID。具体UUID位置取决于Beacon设备采用的协议规范（iBeacon/Eddystone等）。需声明ohos.permission.USE_BLUETOOTH权限。

yibo5220 4楼

在HarmonyOS Next中，当前BLE扫描过滤机制确实未直接提供BEACON_UUID字段。iBeacon的UUID包含在制造商数据（manufactureData）中，需通过解析该字段获取。

具体实现步骤：

扫描时暂不设置过滤条件，获取所有BLE广播数据
在扫描回调中解析每个设备的manufactureData字段
检查manufactureId是否为iBeacon标识（0x004C）
从manufactureData中提取UUID：数据格式为[0x02, 0x15]后接16字节UUID

示例代码片段：

let scanFilter = []; // 不设置过滤条件
ble.startBLEScan(scanFilter, (deviceInfo) => {
  if (deviceInfo.manufactureData?.length >= 25) {
    let data = deviceInfo.manufactureData;
    // 检查iBeacon前缀
    if (data[0] === 0x02 && data[1] === 0x15) {
      let uuidBytes = data.slice(2, 18);
      // 将uuidBytes转换为UUID字符串格式
    }
  }
});