uniapp实现蓝牙小票打印功能

发布网友发布时间：2022-11-05 19:27

我来回答

共1个回答

热心网友时间：2023-01-26 01:39

最近的一个项目增加了小票蓝牙打印的功能，由于之前对蓝牙打印机了解不多，所以遇到的坑比较多，花了点时间把蓝牙连接、打印模块封装成通用组件，并写了个打印的例子，这里做个记录，以防忘记。

组件：组件例子

项目需要实现的是App端连接蓝牙打印机，打印的内容包括：

1、公司logo（本地图片）

2、指定格式与排版的文本数据（直线、中英文）

3、签名的图片数据（接口传回的网络图片地址）

首先要想能打印，蓝牙肯定要连接上，开发前了解一下低功耗蓝牙连接操作流程：

按照api来走一遍从连接到打印的流程：

这里我将蓝牙连接和打印的流程封装在组件使用，父组件中只需在onPrint方法中拼接指令，通过bufferData属性将拼接好的指令数据传入组件内部即可进行打印操作，onPrintSuccess和onPrintFail分别为打印成功与失败的回调：

组件内部的实现如下：

1、点击打印按钮，打开蓝牙适配器(openBluetoothAdapter),并获取已连接的设备（getConnectedBluetoothDevices），如果没有已连接的设备则打开搜索设备弹框进行设备搜索（第2步），若设备已连接，则执行打印方法（第4步）

这里的blesdk是为了方便使用，把uniapp蓝牙相关的api统一放到一个文件中，并将方法转为异步,其中还包括添加CPCL指令的字符拼接方法。gbk是一个用于将数据转码为打印机能够接受的数据格式的模块

2、打开搜索设备弹框（isShowSearch控制弹框显示隐藏）

点击开始搜索（startBluetoothDevicesDiscovery），并监听搜索到的新设备（onfindBlueDevices），蓝牙搜索的操作比较耗费系统资源，所以建议在连接上设备、页面销毁时关闭搜索（stopBlueDevicesDiscovery）,这里，我加了两个按钮控制搜索的开关

由于加了筛选条件（rssi和设备名、设备ID）因此需要对onfindBlueDevices监听到的设备列表进行筛选

3、设备列表点击选择连接设备

①设备列表中的每一项都可以获取到设备的name、deviceId等信息，连接时我们需要的就是deviceId，创建蓝牙连接（createBLEConnection），在这之前可以通过onBLEConnectionStateChange监听连接状态的变化

②连接成功后顺便把搜索设备开关关掉。连接成功后需要通过deviceId获取设备服务(getBLEDeviceServices),这里获取时需要给方法设个延时，否则获取出来的serviceId会是空的

③获取设备服务成功后会返回servicesId数组，接着我们需要用deviceId和serviceId来获取特征值（getDeviceCharacteristics）

④获取到特征值之后需要找个变量将特征值暂存，因为后续向打印机发送数据时需要用到特征值。关闭搜索弹框

4、在连接上设备后，点击打印按钮，这时就可以开始拼接打印数据了。在第1步中做过判断如果有已连接设备，则开始拼接数据并打印，这里将拼接的任务交给父页面(onPrint),拼接完成后通过bufferData传入，在bufferData数据更新后开始将数据发送给设备，所需的参数即opt中的参数，deviceId为设备id；serviceId为服务id；characteristicId为特征码；value为写入的数据，需转成GBK格式；lasterSuccess为数据全部发送成功的回调；onceLength为分包发送的每个数据包长度，因为安卓和iOS有不同，所以加个判断。sendDataToDevice中封装了分包发送的方法。

5、父页面的onPrint中拼接bufferData数据，添加CPCL指令的方法放在bluetoolth.js中（@/components/kk-printer/utils/bluetoolth.js），以下为组件示例展示的一部分常用的指令拼接方法，可查看项目中的@/components/kk-printer/utils/bluetoolth.js文件了解指令封装方法的具体实现

6、实际项目中使用：

①页面引入并使用components文件夹中的kk-printer组件

②使用组件

拼接数据时将不同的打印需求分不同方法拼接

打印logo图片、打印签名图片，在canvasGetImageData前需要注意加个延时或等待draw()完成后执行，不然获取到的图像像素点数据会全是0。使用addCPCLImageCmd时注意调整灰度值threshold，灰度值过高或过低会导致低于灰度值的图像像素点在方法中被筛掉，变成0

addBaseInfo：打印基本信息

addTicketsInfo：打印提单信息

这两个都是打印文本与排版的，没有什么难点

最后讲一下数据（bufferData）拼接的注意点：

①向蓝牙打印机发送数据打印，发送的任何内容都应该要转成二进制数据，而且蓝牙打印的文本编码是GBK的，发送中文需转成GBK编码再转成二进制数据发送，包括发送打印机指令也要转成二进制数据发送

②蓝牙打印机一次接收的二级制数据有*，不同的系统不同的蓝牙设备*可能不同，建议一次20个字节，做递归分包发送

③发送完要打印的内容后，一定要发送一个打印的指令才能顺利打印（部分指令不需要）

④在分包发送的时候，由于设备连接不稳定，经常会出现10007，找不到特征值的情况，需要在失败回调中记录断点，继续发送后续的包