HarmonyOS 鸿蒙Next关于低功耗蓝牙持久化设备ID（addPersistentDeviceId）的两个问题

您好，你的第一个问题如下：您使用 access.addPersistentDeviceId 接口持久化虚拟MAC地址的方案正确，这是实现BLE设备快速回连的核心方法1。以下是关键要点和注意事项：

一、实现原理与背景

1. 虚拟MAC地址机制

   • 未配对设备通过蓝牙扫描获取的地址是随机虚拟MAC地址，设备重启/蓝牙开关操作会导致该地址变化（[检索信息1][检索信息2]）。
   • 调用 access.addPersistentDeviceId 后：
   • 虚拟MAC地址会被固化，即使设备重启也不会改变（[检索信息1 FAQ]）。
   • 需配合权限 ohos.permission.PERSISTENT_BLUETOOTH_PEERS_MAC 使用（[检索信息1]）。

2. 对比配对方案

二、代码实现步骤

1. 首次连接时固化地址（扫描阶段）

import ble from '@ohos.bluetooth.ble';
import access from '@ohos.access';

// 扫描到目标设备时固化其地址
onReceiveEvent = (scanResult: Array<ble.ScanResult>) => {
  if (scanResult.length > 0 && scanResult.deviceId === "目标设备ID") {
    try {
      access.addPersistentDeviceId(scanResult.deviceId); // 持久化虚拟MAC地址
    } catch (err) {
      console.error('固化失败，错误码: ' + err.code);
    }
  }
};

// 开始扫描
ble.on('BLEDeviceFind', this.onReceiveEvent);
ble.startBLEScan([], { interval: 500 });

2. 重连时获取已固化地址

try {
  const deviceIds: string[] = access.getPersistentDeviceIds(); // 获取所有固化地址
  if (deviceIds.length > 0) {
    const targetDevice = deviceIds; // 此处按业务逻辑选择设备
    // 直接使用固化地址创建连接
    const device = ble.createGattClientDevice(targetDevice);
    device.connect();
  }
} catch (err) {
  console.error('获取固化地址失败，错误码: ' + err.code);
}

三、注意事项

1. 权限申请
   • 在 module.json5 中声明权限：

"requestPermissions": [
  {
    "name": "ohos.permission.PERSISTENT_BLUETOOTH_PEERS_MAC"
  }
]

• 运行时动态申请ACL权限

第二个问题：

针对管理多个蓝牙设备的持久化与区分问题，结合鸿蒙系统特性，解决方案如下：

一、持久化存储多个设备地址 在扫描到每个车辆（蓝牙设备）时，需立即调用 access.addPersistentDeviceId() 持久化其虚拟地址：

import { access, ble } from '@ohos.bluetooth';

// 扫描回调中持久化所有发现的车辆设备
onReceiveEvent = (scanResults: Array<ble.ScanResult>) => {
  scanResults.forEach(result => {
    if (result.name.includes("Vehicle_")) { // 根据设备名特征识别车辆
      try {
        // 关键步骤：持久化每个设备的虚拟地址
        access.addPersistentDeviceId(result.deviceId);
        console.info(`已持久化车辆设备: ${result.deviceId}`);
      } catch (err) {
        console.error(`持久化失败: ${err.code}, ${err.message}`);
      }
    }
  });
};

// 启动扫描
ble.on('BLEDeviceFind', this.onReceiveEvent);
ble.startBLEScan([], { interval: 1000 });

二、区分多设备的策略

1. 设备标识绑定

持久化后通过 access.getPersistentDeviceIds() 获取所有设备地址时，需建立自定义映射关系：

// 设备管理类示例
class VehicleManager {
  private deviceMap: Map<string, string> = new Map(); // <deviceId, vehicleName>

  // 添加设备到映射表
  addVehicle(deviceId: string, customName: string) {
    this.deviceMap.set(deviceId, customName);
    // 实际项目需持久化该映射关系（如使用Preferences存储）
  }

  // 获取所有已管理的车辆
  getPersistentVehicles() {
    try {
      const deviceIds = access.getPersistentDeviceIds();
      return deviceIds.map(id => ({
        deviceId: id,
        vehicleName: this.deviceMap.get(id) || "未命名车辆"
      }));
    } catch (err) {
      console.error(`获取设备列表失败: ${err.code}`);
      return [];
    }
  }
}

// 使用示例
const manager = new VehicleManager();
manager.addVehicle("XX:XX:XX:XX:XX:01", "主车辆");
manager.addVehicle("YY:YY:YY:YY:YY:02", "备用车辆");

2. 连接时设备区分

基于持久化地址连接特定车辆：

async connectVehicle(targetId: string) {
  try {
    const gattDevice = ble.createGattClientDevice(targetId);
    await gattDevice.connect();
    console.info(`已连接: ${manager.deviceMap.get(targetId)}`);
  } catch (err) {
    console.error(`连接失败: ${err.code}`);
  }
}

三、关键注意事项

1. 权限声明： 在 module.json5 中添加：

"requestPermissions": [
  {
    "name": "ohos.permission.PERSISTENT_BLUETOOTH_PEERS_MAC",
    "reason": "管理多车辆蓝牙连接"
  }
]

1. 地址稳定性：

   • 持久化后的虚拟地址不会因蓝牙重启而改变（物理MAC不变前提下）
   • 同一车辆多次扫描的虚拟地址在持久化后保持唯一

2. 设备管理建议：

   • 为每个车辆设备设置唯一标识（如车牌号）
   • 在UI层展示时使用 vehicleName + 后四位地址 的组合（例：主车辆 (XX01)）
   • 定期校验设备可用性（通过 ble.getConnectedDevices()）

HarmonyOS Next中addPersistentDeviceId接口用于将低功耗蓝牙设备ID持久化存储至系统白名单。持久化后设备重连时系统会自动建立连接，无需重复扫描。该接口需在扫描到设备后调用，仅对已绑定的BLE设备生效。设备ID通常指MAC地址或由系统生成的唯一标识符。持久化记录在设备恢复出厂设置或应用卸载时会被清除。