UniAPP传统蓝牙

UniAPP 传统蓝牙开发指南

UniAPP 支持通过传统蓝牙（Classic Bluetooth）进行设备通信，适用于需要与蓝牙外设（如打印机、POS机等）交互的场景。以下是关键实现方法和注意事项：

初始化蓝牙模块

在 onLoad 或页面初始化时调用 openBluetoothAdapter 开启蓝牙模块：

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

搜索附近蓝牙设备

通过 startBluetoothDevicesDiscovery 开始搜索，监听 onBluetoothDeviceFound 获取设备列表：

uni.startBluetoothDevicesDiscovery({
  services: ['00001101-0000-1000-8000-00805F9B34FB'], // 常用SPP服务UUID
  success(res) {
    uni.onBluetoothDeviceFound(foundDevices => {
      console.log('发现设备:', foundDevices.devices);
    });
  }
});

连接目标设备

使用 createBLEConnection 建立连接，需指定设备ID：

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

数据读写操作

发送数据
通过 writeBLECharacteristicValue 发送指令：

const buffer = new ArrayBuffer(8);
const dataView = new DataView(buffer);
dataView.setUint8(0, 0x01); // 示例指令
uni.writeBLECharacteristicValue({
  deviceId,
  serviceId,
  characteristicId,
  value: buffer,
  success() {
    console.log('写入成功');
  }
});

接收数据
监听 onBLECharacteristicValueChange：

uni.onBLECharacteristicValueChange(res => {
  const value = new Uint8Array(res.value);
  console.log('收到数据:', value);
});

断开连接与释放资源

操作完成后需主动断开连接并关闭适配器：

uni.closeBLEConnection({ deviceId });
uni.closeBluetoothAdapter();

兼容性说明

1. 平台差异

   

   • Android 需声明蓝牙权限：

     <uses-permission android:name="android.permission.BLUETOOTH" />
     <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />

   • iOS 需在 manifest.json 中添加 bluetooth 权限声明。

2. 服务UUID
   传统蓝牙通常使用 SPP 协议，标准UUID为 00001101-0000-1000-8000-00805F9B34FB。

常见问题处理

• 搜索不到设备
  检查设备是否处于可发现模式，Android 需开启位置权限。

• 连接失败
  确认设备ID和服务UUID是否正确，部分设备需要配对后才能连接。

• 数据传输异常
  确保数据格式符合设备协议要求，建议使用十六进制调试工具分析。

通过以上步骤可实现UniAPP与传统蓝牙设备的基本交互，实际开发中需根据具体设备协议调整数据格式和处理逻辑。