uniapp 蓝牙功能如何使用

在uniapp中如何使用蓝牙功能？具体需要调用哪些API？开发过程中需要注意哪些兼容性问题？安卓和iOS平台的蓝牙接口调用方式是否有差异？能否提供一个完整的蓝牙设备连接和数据传输的示例代码？

ionicwang 1楼作者

UniApp蓝牙使用步骤：

初始化蓝牙： uni.openBluetoothAdapter() 开启蓝牙模块
监听事件：
- onBluetoothDeviceFound 发现设备
- onBLEConnectionStateChange 连接状态变化
搜索设备： uni.startBluetoothDevicesDiscovery() 开始搜索
连接设备： uni.createBLEConnection() 连接指定设备
获取服务： uni.getBLEDeviceServices() 获取服务列表
获取特征值： uni.getBLEDeviceCharacteristics() 获取特征值
读写数据：
- uni.writeBLECharacteristicValue() 写入数据
- uni.notifyBLECharacteristicValueChange() 监听数据变化
断开连接： uni.closeBLEConnection()

注意：

安卓需要定位权限
设备需支持BLE
使用前检查蓝牙状态
及时关闭蓝牙模块节省电量

建议先看官方文档，再结合具体业务逻辑开发。

zlyuanteng 2楼

在 UniApp 中使用蓝牙功能主要通过 uni 提供的蓝牙 API 实现，适用于连接外部设备（如打印机、传感器等）。以下是核心步骤和示例代码：

1. 初始化蓝牙模块

首先检查设备蓝牙状态并初始化：

uni.openBluetoothAdapter({
  success: () => {
    console.log('蓝牙初始化成功');
    // 开始搜索设备
    uni.startBluetoothDevicesDiscovery({
      success: () => console.log('开始搜索设备')
    });
  },
  fail: (err) => {
    console.log('初始化失败：', err);
  }
});

2. 监听发现设备

实时获取搜索到的蓝牙设备：

uni.onBluetoothDeviceFound((devices) => {
  console.log('发现设备：', devices.devices);
  // 可保存设备列表供用户选择
});

3. 连接设备

选择目标设备并建立连接：

uni.createBLEConnection({
  deviceId: '目标设备ID', // 从发现的设备列表中获取
  success: () => {
    console.log('连接成功');
    // 获取设备服务列表
    uni.getBLEDeviceServices({
      deviceId: '目标设备ID',
      success: (res) => {
        console.log('服务列表：', res.services);
      }
    });
  }
});

4. 读写数据

获取特征值并监听数据变化：

// 获取特征值（需替换为实际 serviceId 和 characteristicId）
uni.getBLEDeviceCharacteristics({
  deviceId: '设备ID',
  serviceId: '服务UUID',
  success: (res) => {
    console.log('特征值：', res.characteristics);
  }
});

// 启用数据监听
uni.notifyBLECharacteristicValueChange({
  deviceId: '设备ID',
  serviceId: '服务UUID',
  characteristicId: '特征UUID',
  state: true
});

// 接收数据
uni.onBLECharacteristicValueChange((res) => {
  console.log('收到数据：', res.value);
});

// 发送数据（需转为 ArrayBuffer）
uni.writeBLECharacteristicValue({
  deviceId: '设备ID',
  serviceId: '服务UUID',
  characteristicId: '特征UUID',
  value: new ArrayBuffer(8)
});

5. 断开连接

操作完成后断开连接：

uni.closeBLEConnection({ deviceId: '设备ID' });
uni.closeBluetoothAdapter(); // 关闭蓝牙模块

注意事项

权限配置：在 manifest.json 中申请蓝牙权限（App 平台需配置，小程序自动处理）。
设备兼容性：不同设备的服务 UUID 和特征值可能不同，需根据硬件文档调整。
错误处理：所有 API 需添加 fail 回调处理异常（如用户拒绝授权、设备不支持等）。