uniapp蓝牙设备对接实战：从打印机编码转换到电子秤数据监听

最新推荐文章于 2026-02-14 02:58:14 发布

原创

最新推荐文章于 2026-02-14 02:58:14 发布 · 53 阅读

标签

#uniapp #蓝牙设备 #打印机 #电子秤

1. 蓝牙设备对接的核心挑战

在移动应用开发中，蓝牙设备对接一直是让开发者头疼的问题。我做过不少uniapp项目，发现对接打印机和电子秤时，真正的难点往往不是基础连接，而是后续的数据处理。打印机需要处理GBK编码转换，电子秤要实时监听数据流，这两个需求看似简单，实际开发中却暗藏玄机。

先说打印机，市面上80%的热敏打印机都采用GBK编码，而我们的uniapp默认使用UTF-8。这就好比两个人在对话，一个说中文，一个说俄语，完全对不上频道。更麻烦的是，手机端无法直接使用浏览器的TextDecoder API，这个坑我当初踩了整整两天。

电子秤的难点在于数据监听机制。不同于打印机单向发送指令，电子秤需要持续接收数据变化。很多新手会遇到数据丢包、延迟显示的问题，其实是因为没处理好蓝牙特征值的订阅机制。我见过最夸张的案例，电子秤数值要等5秒才刷新，用户体验直接崩盘。

2. 蓝牙连接全流程解析

2.1 初始化蓝牙模块

蓝牙对接的第一步永远是初始化，这个环节最容易出现权限问题。在安卓6.0以上系统，必须动态申请位置权限，因为蓝牙扫描需要用到定位服务。下面是经过实战检验的初始化代码：

uni.openBluetoothAdapter({
  success: (res) => {
    console.log('蓝牙适配器初始化成功');
    this.startDiscovery();
  },
  fail: (err) => {
    if (err.errCode === 10001) {
      uni.showToast({ title: '请开启蓝牙功能', icon: 'none' });
    }
  }
});

关键点：一定要处理10001错误码，这是用户没开蓝牙的情况。我建议在fail回调里增加引导开启蓝牙的UI提示，比干巴巴的报错友好得多。

2.2 设备发现与连接

搜索设备时有个隐藏坑点：不同平台的表现差异。iOS会返回所有蓝牙设备，而安卓只返回可连接设备。建议增加设备过滤逻辑：

uni.onBluetoothDeviceFound((res) => {
  res.devices.forEach(device => {
    if (device.name?.includes('MPT-II') || device.localName?.includes('ANDZ')) {
      this.targetDevice = device;
      uni.stopBluetoothDevicesDiscovery();
    }
  });
});

连接阶段最易出错的是服务发现。很多开发者会直接获取服务，结果返回空列表。这是因为蓝牙连接需要时间协商，必须加延迟：

setTimeout(() => {
  uni.getBLEDeviceServices({
    deviceId: deviceId,
    success: (res) => {
      res.services.forEach(service => {
        this.getCharacteristics(deviceId, service.uuid);
      });
    }
  });
}, 800); // 实测800ms是最稳的等待时间