鸿蒙Next中BLE配对如何实现

在鸿蒙Next系统中，如何实现BLE设备的配对功能？具体需要调用哪些API接口？配对过程中有哪些注意事项或者常见问题需要避免？希望能提供一个详细的实现步骤或代码示例。

yuanlaile 1楼作者

鸿蒙Next中BLE配对？简单说就是“蓝牙相亲”流程：

设备先广播“我单身！”（Advertise）
手机扫码（Scan）后发起“加个微信？”（Pairing Request）
双方交换密码（Passkey）或点头确认（Just Works）
牵手成功！绑定后下次自动识别～
代码？用@ohos.bluetooth接口，配个createBond就行，剩下的系统帮你搞定！

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

sinazl 2楼

在鸿蒙Next中，BLE（蓝牙低功耗）配对主要通过以下步骤实现，涉及权限申请、设备扫描、配对连接及数据交互。以下是关键流程和示例代码：

1. 权限申请

在module.json5文件中添加蓝牙权限：

{
  "module": {
    "requestPermissions": [
      {
        "name": "ohos.permission.USE_BLUETOOTH"
      },
      {
        "name": "ohos.permission.DISCOVER_BLUETOOTH"
      },
      {
        "name": "ohos.permission.MANAGE_BLUETOOTH"
      },
      {
        "name": "ohos.permission.LOCATION"
      }
    ]
  }
}

2. 初始化蓝牙适配器

获取蓝牙适配器实例：

import bluetooth from '[@ohos](/user/ohos).bluetooth';

let adapter = bluetooth.getDefaultAdapter();

3. 扫描并发现设备

启动扫描并监听设备发现：

// 开始扫描
adapter.startBluetoothDiscovery();

// 监听设备发现
adapter.on('deviceDiscover', (device) => {
  console.log(`发现设备: ${device.deviceName}, 地址: ${device.deviceId}`);
  // 可在此保存设备信息用于配对
});

4. 配对设备

使用设备地址发起配对：

let deviceId = 'XX:XX:XX:XX:XX:XX'; // 替换为目标设备地址
adapter.pairDevice(deviceId, (err) => {
  if (err) {
    console.error(`配对失败: ${err.code}`);
  } else {
    console.log('配对成功');
  }
});

5. 连接GATT服务

配对后连接GATT以进行数据通信：

import { gatt } from '[@ohos](/user/ohos).bluetooth';

let gattClient;
gattClient = gatt.createGattClientDevice(deviceId);
gattClient.connect((err) => {
  if (err) {
    console.error(`GATT连接失败: ${err.code}`);
  } else {
    console.log('GATT连接成功');
    // 发现服务并读写特征值
  }
});

注意事项：

配对方式：鸿蒙Next默认使用LE Secure Connections（若设备支持），否则回退到传统配对。
用户确认：系统可能弹出配对对话框，需用户手动确认。
错误处理：检查错误码（如3301001表示权限失败），确保权限已授予。
兼容性：确保目标BLE设备符合蓝牙4.0及以上规范。