硬件对接小程序开发：蓝牙打印机的控制逻辑实战
最近在搞小程序对接蓝牙热敏打印机的项目，踩了不少坑，也积累了点硬核经验。这玩意儿看着简单，不就是发个数据过去让它打印吗？真上手才发现，从设备发现到稳定输出，每个环节都可能翻车。今天把核心控制逻辑掰开了揉碎了讲讲，给同行们省点折腾的时间。
第一步：找准设备，建立稳定连接
小程序里调用 wx.openBluetoothAdapter 启动蓝牙模块是敲门砖。关键在设备发现阶段：别一股脑把所有蓝牙设备都扫出来，得用 services 参数精准过滤。蓝牙打印机通常暴露特定的 Service UUID（比如热敏打印机常用的 EPSON ESC/POS 协议服务 UUID：000018F0-0000-1000-8000-00805F9B34FB）。这一步筛不准，后面全是白忙活。
连设备时，wx.createBLEConnection 是入口，但别以为连上就万事大吉。安卓和 iOS 在连接策略上拧巴得很。安卓设备经常需要手动触发一次 wx.getBLEDeviceServices 和 wx.getBLEDeviceCharacteristics 才能真正“激活”通信通道，iOS 有时反而能自动完成。这一步没处理好，后续读写特征值绝对报错。
第二步：摸透特征值，搞定数据收发
连上设备只是拿到了门票，读写操作全靠 Characteristic（特征值）。打印机一般有两个关键特征值：一个用于写入指令和数据（Write Characteristic），一个用于接收打印机状态反馈（Notify Characteristic）。务必通过 wx.getBLEDeviceCharacteristics 确认它们的 UUID 和属性（properties）。写数据的特征值必须支持 Write 或 WriteWithoutResponse。
发数据用 wx.writeBLECharacteristicValue，这里藏着大坑：小程序要求写入的数据必须是 ArrayBuffer 格式。打印指令（ESC/POS, TSPL, CPCL 等）通常是二进制指令或文本，得用 Uint8Array 或 TextEncoder 老老实实转成 ArrayBuffer。别想着偷懒用 base64，某些机型或打印机固件直接不认。
重点来了：BLE 单次写入数据包有 MTU 限制（通常是 20 字节左右）。想打一张大图片或者长文本？老老实实分包！写个循环，每次切一小段数据发过去，并确保前一个包写成功（在 writeBLECharacteristicValue 的 success 回调里）再发下一个。乱序发送？打印机吐出来的内容能让你怀疑人生。
第三步：稳住连接，盯紧打印机状态
蓝牙不是有线，稳定性是老大难。必须监听 wx.onBLEConnectionStateChange。一旦断连，得有自动重连机制。但别傻乎乎地无限重试，加个次数限制和延迟，避免耗电和死循环。
想实现“打印完成”这类业务逻辑？得靠那个 Notify 特征值。启用通知 wx.notifyBLECharacteristicValueChange 后，通过 wx.onBLECharacteristicValueChange 监听打印机回传的状态包。不同打印机状态码格式天差地别，有的用单个字节位标记（比如 0x08 表示缺纸），有的是一串特定报文。把打印机手册里关于状态查询和响应的章节翻烂，写个解析函数才算完事。
第四步：错误处理，一个都不能漏
蓝牙打印的幺蛾子太多了，错误处理必须覆盖到骨子里：
1. 适配器状态异常：用户没开蓝牙、不支持BLE、授权被拒？wx.getBluetoothAdapterState 和错误回调先兜住。 2. 设备连接失败/断开：超时、距离远、干扰大、设备关机？重连策略和用户提示要跟上。 3. 写入失败：数据格式不对、特征值不支持写、MTU超限？检查数据转换逻辑和分包大小。 4. 打印机无响应：发完指令没动静？检查特征值是否选对，监听通知是否开启，或者打印机本身是不是卡纸/缺纸/关机了。 5. 指令解析失败：打印机乱码或执行错误？确认发送的 ArrayBuffer 数据完全符合打印机要求的指令集格式，一个字节都不能错。 6. 多设备干扰：附近一堆蓝牙设备？发现和连接时用 deviceId 精准锁定目标。 7. 系统级限制：iOS 对后台蓝牙操作限制极严，小程序切后台后通信可能被挂起，要有心理预期。
第五步：实战优化要点
连接缓存：用户上次连过的打印机，把 deviceId 存下来（localStorage或云存储），下次优先尝试直连，省去搜索步骤。 指令封装：把常用的打印文本、图片、条码、切纸等操作封装成函数，传入参数直接吐出对应的 ArrayBuffer 指令集，业务逻辑清爽多了。 状态轮询：如果打印机不支持 Notify 或 Notify 不稳定，只能定时（比如每秒）主动发送状态查询指令（ESC/POS 里是 DLE EOT n）来获取状态，虽然土但有效。 超时处理：任何 BLE 操作（连接、写入）都要设个超时（比如 10 秒），避免用户傻等。 * 日志输出：把关键的蓝牙操作步骤、发送的指令数据（转成16进制字符串方便看）、接收到的数据、错误信息都打出来。线上出问题，没日志就是两眼一抹黑。
搞小程序蓝牙打印，就是个和不同手机系统、不同蓝牙模块、不同打印机固件斗智斗勇的过程。手册是圣经，日志是眼睛，耐心是法宝。核心逻辑就是：精准发现 -> 稳定连接 -> 正确转换并分包写入指令 -> 有效监听状态/处理错误。把这几个环节的铁闸焊死，打印流程才能顺畅跑起来。纸上得来终觉浅，真想摸透，还是得找台热敏打印机，接上调试线，一行代码一行指令地啃。设备厂商给的协议文档，才是真正的通关秘籍。
