鸿蒙Next FastBLE使用问题求助

在鸿蒙Next上使用FastBLE时遇到了连接不稳定问题，具体表现为设备频繁断开连接。已按照文档配置了权限和初始化代码，但问题依旧存在。请问是否有已知的兼容性问题？或者需要特殊的配置方式？调试日志显示错误码为0x108，但官方文档未明确说明该错误码含义。求指教！

2 回复

鸿蒙Next上FastBLE罢工了？别慌！先检查权限和UUID配置，八成是这里挖了坑。如果还连不上，试试重启大法——毕竟“重启解决90%问题，重装解决99%问题”是程序员祖传秘方。需要具体报错？我随时待命！

更多关于鸿蒙Next FastBLE使用问题求助的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


您好！关于鸿蒙Next（HarmonyOS NEXT）上使用FastBLE的问题，我很乐意为您提供帮助。

首先，需要明确一个关键点：鸿蒙NEXT是一个纯血鸿蒙系统，它不再兼容安卓APK。 因此，您之前在Android上使用的、基于安卓API的FastBLE库将无法直接在鸿蒙NEXT上运行。

您需要转向使用华为为鸿蒙NEXT全新设计的蓝牙API。这套API位于@kit.ConnectivityKit包中，是开发鸿蒙应用连接蓝牙设备的官方标准。

核心步骤与代码示例

以下是在鸿蒙NEXT上进行BLE设备扫描、连接和数据交互的基本流程和代码片段。

1. 申请权限

首先，您需要在module.json5文件中声明必要的权限。

{
  "module": {
    "requestPermissions": [
      {
        "name": "ohos.permission.ACCESS_BLUETOOTH"
      },
      {
        "name": "ohos.permission.DISCOVER_BLUETOOTH"
      },
      {
        "name": "ohos.permission.MANAGE_BLUETOOTH"
      },
      // 如果需要定位，还需申请（类似安卓）
      {
        "name": "ohos.permission.LOCATION"
      }
    ]
  }
}

2. 初始化蓝牙管理器

import { bluetoothManager } from '@kit.ConnectivityKit';

// 1. 获取蓝牙管理器实例
let bluetooth = bluetoothManager.getBluetoothManager();

// 2. 检查并打开蓝牙（需要用户授权）
async function enableBluetooth() {
  try {
    if (!bluetooth.isBluetoothAvailable()) {
      console.error('Bluetooth is not available on this device.');
      return;
    }
    if (!bluetooth.isBluetoothEnabled()) {
      // 此方法会触发系统弹窗请求用户开启蓝牙
      await bluetooth.enableBluetooth();
    }
    console.log('Bluetooth is enabled.');
  } catch (error) {
    console.error('Failed to enable Bluetooth:', error);
  }
}

3. 扫描BLE设备

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

// 定义扫描结果回调
let scanCallback = {
  onScanResult: (device: ble.ScanResult) => {
    // 在这里处理扫描到的设备
    console.log(`Found Device: ${device.device?.name}, Address: ${device.device?.deviceId}, RSSI: ${device.rssi}`);
    // 您可以将设备信息存入一个列表，供用户选择
  }
};

// 开始扫描
async function startScan() {
  try {
    let filter : ble.ScanFilter = { // 可以设置扫描过滤器，例如设备名称或服务UUID
      // deviceName: 'MyDevice',
      // serviceUuid: '0000180F-0000-1000-8000-00805F9B34FB'
    };
    let scanOptions : ble.ScanOptions = {
      interval: 0, // 扫描间隔
      dutyMode: ble.ScanDuty.SCAN_MODE_LOW_POWER, // 扫描模式
      matchMode: ble.MatchMode.MATCH_MODE_AGGRESSIVE // 匹配模式
    };

    await ble.createBleScanner().startScan([filter], scanOptions, scanCallback);
    console.log('BLE scan started.');
  } catch (error) {
    console.error('Failed to start scan:', error);
  }
}

// 停止扫描
async function stopScan() {
  try {
    await ble.createBleScanner().stopScan();
    console.log('BLE scan stopped.');
  } catch (error) {
    console.error('Failed to stop scan:', error);
  }
}

4. 连接设备与发现服务

// 假设您已经从扫描结果中获取了一个 deviceId
let targetDeviceId: string = 'XX:XX:XX:XX:XX:XX'; // 替换为实际设备地址

// 创建 BLE 客户端
let client = ble.createGattClientDevice(targetDeviceId);

// 连接设备
async function connectDevice() {
  try {
    await client.connect();
    console.log('Device connected.');

    // 连接成功后，发现服务
    let services = await client.discoverServices();
    console.log('Services discovered.');

    for (let service of services) {
      console.log(`Service UUID: ${service.serviceUuid}`);
      // 遍历服务的特征值...
      for (let characteristic of service.characteristics) {
        console.log(`-- Characteristic UUID: ${characteristic.characteristicUuid}`);
      }
    }

  } catch (error) {
    console.error('Connection failed:', error);
  }
}

5. 读写特征值

// 假设您已经获取到了目标特征值对象 char
async function readCharacteristic(char: ble.BLECharacteristic) {
  try {
    let value = await client.readCharacteristic(char);
    console.log('Read value:', value); // value 是一个 Unit8Array
  } catch (error) {
    console.error('Read failed:', error);
  }
}

async function writeCharacteristic(char: ble.BLECharacteristic, data: Uint8Array) {
  try {
    await client.writeCharacteristic(char, data);
    console.log('Write successful.');
  } catch (error) {
    console.error('Write failed:', error);
  }
}

// 订阅通知
async function enableNotification(char: ble.BLECharacteristic) {
  try {
    await client.setNotifyCharacteristicChanged(char, true);
    // 需要监听特征值变化的事件
    client.on('characteristicChange', (characteristic: ble.BLECharacteristic) => {
      if (characteristic.characteristicUuid === char.characteristicUuid) {
        console.log('Notification received:', characteristic.value);
      }
    });
  } catch (error) {
    console.error('Enable notification failed:', error);
  }
}

总结与建议

  1. 彻底迁移：您需要将原来基于FastBLE的Android代码，按照鸿蒙NEXT的@kit.ConnectivityKit API进行重写。
  2. 查阅官方文档：这是最权威和最新的信息来源。请务必查阅华为官方发布的 HarmonyOS应用开发文档 中的“蓝牙”部分。
  3. 注意生命周期：在Page的onPageHide或App的onDestroy等生命周期中，记得断开BLE连接、停止扫描，释放资源。
  4. 调试工具：使用真机进行调试，并可以利用华为提供的DevEco Studio中的调试工具来查看日志和系统状态。

虽然从Android迁移到鸿蒙NEXT需要一些工作量，但新的API设计清晰，只要熟悉了基本流程，开发起来会非常顺畅。希望这些信息能帮助您顺利解决在鸿蒙NEXT上的BLE开发问题！

回到顶部