uniapp蓝牙功能概述

uniapp提供了跨平台的蓝牙API，支持在iOS和Android设备上实现蓝牙设备的扫描、连接、数据传输等功能。开发者可通过uni蓝牙模块实现设备交互，适用于智能硬件、健康设备等场景。

蓝牙API核心方法

初始化蓝牙模块
调用uni.openBluetoothAdapter初始化蓝牙适配器，需在onLoad或用户触发时执行。失败时需检查设备蓝牙是否开启或兼容性。

uni.openBluetoothAdapter({
  success(res) {
    console.log('蓝牙适配器初始化成功');
  },
  fail(err) {
    console.error('初始化失败:', err);
  }
});

扫描蓝牙设备
使用uni.startBluetoothDevicesDiscovery扫描周围设备，并通过onBluetoothDeviceFound监听发现的设备。

uni.startBluetoothDevicesDiscovery({
  services: ['FFE0'], // 指定服务UUID（可选）
  success(res) {
    uni.onBluetoothDeviceFound(device => {
      console.log('发现设备:', device);
    });
  }
});

停止扫描
扫描完成后调用uni.stopBluetoothDevicesDiscovery节省电量。

设备连接与通信

连接设备
通过uni.createBLEConnection连接目标设备，需传入设备ID（从扫描结果获取）。

uni.createBLEConnection({
  deviceId: '设备ID',
  success(res) {
    console.log('连接成功');
  }
});

获取服务与特征值
连接后使用uni.getBLEDeviceServices和uni.getBLEDeviceCharacteristics获取服务的特征值，用于读写数据。

数据传输

• 写入数据：通过uni.writeBLECharacteristicValue发送指令。
• 监听数据：使用uni.onBLECharacteristicValueChange接收设备返回的数据。

注意事项

1. 权限配置

   • Android需在manifest.json中添加蓝牙权限：

     "permissions": ["android.permission.BLUETOOTH", "android.permission.BLUETOOTH_ADMIN"]
     

   • iOS需在苹果开发者后台配置蓝牙权限描述。

2. 兼容性问题

   • iOS可能限制部分蓝牙操作（如后台扫描），需在前台进行。
   • 不同设备对MTU（最大传输单元）的支持不同，需分段处理大数据。

3. 错误处理

   • 监听onBluetoothAdapterStateChange处理蓝牙开关状态变化。
   • 调用uni.closeBluetoothAdapter释放资源。

示例应用场景

• 健康设备：读取手环的心率、步数数据。
• 智能家居：控制蓝牙灯泡、门锁。
• 工业设备：与蓝牙传感器交互采集数据。

通过合理调用API和错误处理，可稳定实现跨平台蓝牙功能。