uniapp微信小程序实现连接低功耗蓝牙打印功能

Posted 浮桥

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了uniapp微信小程序实现连接低功耗蓝牙打印功能相关的知识，希望对你有一定的参考价值。

微信小程序项目中有使用到蓝牙连接打印，参考官方文档做了一个参考笔记，这样使用的时候就按着步骤查看。

uni-app蓝牙连接

蓝牙：

1、初始化蓝牙

uni.openBluetoothAdapter(OBJECT)

uni.openBluetoothAdapter(
  success(res) 
    console.log(res)
    // 接口调用成功的回调函数
  ,
  fail:(res)=>
      // 接口调用失败的回调函数
  ,
  complete:()=>
	// 接口调用结束的回调函数（调用成功、失败都会执行）
  
)

错误 ：res.errCode

错误码错误信息说明
0ok正常
10000not init未初始化蓝牙适配器
10001not available当前蓝牙适配器不可用
10002no device没有找到指定设备
10003connection fail连接失败
10004no service没有找到指定服务
10005no characteristic没有找到指定特征值
10006no connection当前连接已断开
10007property not support当前特征值不支持此操作
10008system error其余所有系统上报的异常
10009system not supportandroid 系统特有，系统版本低于 4.3 不支持 BLE

注意

  • 其他蓝牙相关 API 必须在 uni.openBluetoothAdapter 调用之后使用。否则 API 会返回错误（errCode=10000）。
  • 在用户蓝牙开关未开启或者手机不支持蓝牙功能的情况下，调用 uni.openBluetoothAdapter 会返回错误（errCode=10001），表示手机蓝牙功能不可用。此时APP蓝牙模块已经初始化完成，可通过 uni.onBluetoothAdapterStateChange 监听手机蓝牙状态的改变，也可以调用蓝牙模块的所有API。

2、监听蓝牙适配器状态变化事件

uni.onBluetoothAdapterStateChange(CALLBACK)

CALLBACK 返回参数

属性类型说明
availableboolean蓝牙适配器是否可用
discoveringboolean蓝牙适配器是否处于搜索状态

示例代码

uni.onBluetoothAdapterStateChange((res) => 
    console.log('onBluetoothAdapterStateChange', res)
    // available：蓝牙适配器是否可用
    if (res.available) 
        // 取消监听，否则stopBluetoothDevicesDiscovery后仍会继续触发onBluetoothAdapterStateChange，
        // 导致再次调用startBluetoothDevicesDiscovery
        uni.onBluetoothAdapterStateChange(() => );
        // 开始搜寻附近的蓝牙外围设备
        uni.startBluetoothDevicesDiscovery(OBJECT)
    
)

3、开始搜寻附近的蓝牙外围设备

uni.startBluetoothDevicesDiscovery(OBJECT)

此操作比较耗费系统资源，请在搜索并连接到设备后调用 uni.stopBluetoothDevicesDiscovery 方法停止搜索。

OBJECT 参数说明

属性类型默认值必填说明
servicesArray否要搜索但蓝牙设备主 service 的 uuid 列表。某些蓝牙设备会广播自己的主 service 的 uuid。如果设置此参数，则只搜索广播包有对应 uuid 的主服务的蓝牙设备。建议主要通过该参数过滤掉周边不需要处理的其他蓝牙设备。
allowDuplicatesKeybooleanfalse否是否允许重复上报同一设备。如果允许重复上报，则 uni.onBlueToothDeviceFound 方法会多次上报同一设备，但是 RSSI 值会有不同。
intervalnumber0否上报设备的间隔。0 表示找到新设备立即上报，其他数值根据传入的间隔上报。
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

错误

错误码错误信息说明
0ok正常
10000not init未初始化蓝牙适配器
10001not available当前蓝牙适配器不可用
10002no device没有找到指定设备
10003connection fail连接失败
10004no service没有找到指定服务
10005no characteristic没有找到指定特征值
10006no connection当前连接已断开
10007property not support当前特征值不支持此操作
10008system error其余所有系统上报的异常
10009system not supportAndroid 系统特有，系统版本低于 4.3 不支持 BLE

注意：

  • App 端目前仅支持发现ble蓝牙设备，更多蓝牙设备发现，可以使用 Native.js，参考：https://ask.dcloud.net.cn/article/114。也可以在插件市场获取原生插件

示例代码

// 以微信硬件平台的蓝牙智能灯为例，主服务的 UUID 是 FEE7。传入这个参数，只搜索主服务 UUID 为 FEE7 的设备
uni.startBluetoothDevicesDiscovery(
  services: ['FEE7'],
  success(res) 
    console.log(res)
    // 监听寻找到新设备的事件
    uni.onBluetoothDeviceFound(OBJECT)
  
)

4、监听寻找到新设备的事件

uni.onBluetoothDeviceFound(CALLBACK)

CALLBACK 返回参数

属性类型说明
devicesArray新搜索到的设备列表

devices 的结构

属性类型说明
namestring蓝牙设备名称，某些设备可能没有
deviceIdstring用于区分设备的 id
RSSInumber当前蓝牙设备的信号强度
advertisDataArrayBuffer当前蓝牙设备的广播数据段中的 ManufacturerData 数据段。
advertisServiceUUIDsArray当前蓝牙设备的广播数据段中的 ServiceUUIDs 数据段
localNamestring当前蓝牙设备的广播数据段中的 LocalName 数据段
serviceDataObject当前蓝牙设备的广播数据段中的 ServiceData 数据段

注意

示例代码

// ArrayBuffer转16进度字符串示例
function ab2hex(buffer) 
  const hexArr = Array.prototype.map.call(
    new Uint8Array(buffer),
    function (bit) 
      return ('00' + bit.toString(16)).slice(-2)
    
  )
  return hexArr.join('')

uni.onBluetoothDeviceFound(function (devices) 
  console.log('new device list has founded')
  console.dir(devices)
  console.log(ab2hex(devices[0].advertisData))
)

5、停止搜寻附近的蓝牙外围设备

uni.stopBluetoothDevicesDiscovery(OBJECT)

若已经找到需要的蓝牙设备并不需要继续搜索时，建议调用该接口停止蓝牙搜索。

OBJECT 参数说明

属性类型默认值必填说明
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

错误

错误码错误信息说明
0ok正常
10000not init未初始化蓝牙适配器
10001not available当前蓝牙适配器不可用
10002no device没有找到指定设备
10003connection fail连接失败
10004no service没有找到指定服务
10005no characteristic没有找到指定特征值
10006no connection当前连接已断开
10007property not support当前特征值不支持此操作
10008system error其余所有系统上报的异常
10009system not supportAndroid 系统特有，系统版本低于 4.3 不支持 BLE

示例代码

uni.stopBluetoothDevicesDiscovery(
  success(res) 
    console.log(res)
  
)

6、根据 uuid 获取处于已连接状态的设备

uni.getConnectedBluetoothDevices(OBJECT)

OBJECT 参数说明

属性类型默认值必填说明
servicesArray是蓝牙设备主 service 的 uuid 列表
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

success 返回参数说明：

属性类型说明
devicesArray搜索到的设备列表

res.devices 的结构

属性类型说明
namestring蓝牙设备名称，某些设备可能没有
deviceIdstring用于区分设备的 id

错误

错误码错误信息说明
0ok正常
10000not init未初始化蓝牙适配器
10001not available当前蓝牙适配器不可用
10002no device没有找到指定设备
10003connection fail连接失败
10004no service没有找到指定服务
10005no characteristic没有找到指定特征值
10006no connection当前连接已断开
10007property not support当前特征值不支持此操作
10008system error其余所有系统上报的异常
10009system not supportAndroid 系统特有，系统版本低于 4.3 不支持 BLE

示例代码

uni.getConnectedBluetoothDevices(
  success(res) 
    console.log(res)
  
)

7、获取在蓝牙模块生效期间所有已发现的蓝牙设备

uni.getBluetoothDevices(OBJECT)

包括已经和本机处于连接状态的设备。

OBJECT 参数说明

属性类型默认值必填说明
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

success 返回参数说明：

属性类型说明
devicesArrayuuid 对应的的已连接设备列表

res.devices 的结构

属性类型说明
namestring蓝牙设备名称，某些设备可能没有
deviceIdstring用于区分设备的 id
RSSInumber当前蓝牙设备的信号强度
advertisDataArrayBuffer当前蓝牙设备的广播数据段中的 ManufacturerData 数据段。
advertisServiceUUIDsArray当前蓝牙设备的广播数据段中的 ServiceUUIDs 数据段
localNamestring当前蓝牙设备的广播数据段中的 LocalName 数据段
serviceDataObject当前蓝牙设备的广播数据段中的 ServiceData 数据段

错误

错误码错误信息说明
0ok正常
10000not init未初始化蓝牙适配器
10001not available当前蓝牙适配器不可用
10002no device没有找到指定设备
10003connection fail连接失败
10004no service没有找到指定服务
10005no characteristic没有找到指定特征值
10006no connection当前连接已断开
10007property not support当前特征值不支持此操作
10008system error其余所有系统上报的异常
10009system not supportAndroid 系统特有，系统版本低于 4.3 不支持 BLE

示例代码

// ArrayBuffer转16进度字符串示例
function ab2hex(buffer) 
  const hexArr = Array.prototype.map.call(
    new Uint8Array(buffer),
    function (bit) 
      return ('00' + bit.toString(16)).slice(-2)
    
  )
  return hexArr.join('')

uni.getBluetoothDevices(
  success(res) 
    console.log(res)
    if (res.devices[0]) 
      console.log(ab2hex(res.devices[0].advertisData))
    
  
)

注意

  • 该接口获取到的设备列表为蓝牙模块生效期间所有搜索到的蓝牙设备，若在蓝牙模块使用流程结束后未及时调用 uni.closeBluetoothAdapter 释放资源，会存在调用该接口会返回之前的蓝牙使用流程中搜索到的蓝牙设备，可能设备已经不在用户身边，无法连接。
  • 蓝牙设备在被搜索到时，系统返回的 name 字段一般为广播包中的 LocalName 字段中的设备名称，而如果与蓝牙设备建立连接，系统返回的 name 字段会改为从蓝牙设备上获取到的 GattName。若需要动态改变设备名称并展示，建议使用 localName 字段。

8、获取本机蓝牙适配器状态

uni.getBluetoothAdapterState(OBJECT)

OBJECT 参数说明

属性类型默认值必填说明
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

success 返回参数说明：

属性类型说明
discoveringboolean是否正在搜索设备
availableboolean蓝牙适配器是否可用

错误

错误码错误信息说明
0ok正常
10000not init未初始化蓝牙适配器
10001not available当前蓝牙适配器不可用
10002no device没有找到指定设备
10003connection fail连接失败
10004no service没有找到指定服务
10005no characteristic没有找到指定特征值
10006no connection当前连接已断开
10007property not support当前特征值不支持此操作
10008system error其余所有系统上报的异常
10009system not supportAndroid 系统特有，系统版本低于 4.3 不支持 BLE

示例代码

uni.getBluetoothAdapterState(
  success(res) 
    console.log(res)
  
)

9、关闭蓝牙模块

uni.closeBluetoothAdapter(OBJECT)

调用该方法将断开所有已建立的连接并释放系统资源。建议在使用蓝牙流程后，与 uni.openBluetoothAdapter 成对调用。

OBJECT 参数说明

属性类型默认值必填说明
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

错误

错误码错误信息说明
0ok正常
10000not init未初始化蓝牙适配器
10001not available当前蓝牙适配器不可用
10002no device没有找到指定设备
10003connection fail连接失败
10004no service没有找到指定服务
10005no characteristic没有找到指定特征值
10006no connection当前连接已断开
10007property not support当前特征值不支持此操作
10008system error其余所有系统上报的异常
10009system not supportAndroid 系统特有，系统版本低于 4.3 不支持 BLE

示例代码

uni.closeBluetoothAdapter(
  success(res) 
    console.log(res)
  
)

低功耗蓝牙：

1、设置蓝牙最大传输单元

[uni.setBLEMTU(OBJECT)

需在 uni.createBLEConnection调用成功后调用，mtu 设置范围 (22,512)。安卓5.1以上有效。

OBJECT 参数说明

属性类型默认值必填说明
deviceIdstring是用于区分设备的 id
mtunumber是最大传输单元(22,512) 区间内，单位 bytes
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

2、向低功耗蓝牙设备特征值中写入二进制数据

uni.writeBLECharacteristicValue(OBJECT)

注意：必须设备的特征值支持 write 才可以成功调用。

OBJECT 参数说明

属性类型默认值必填说明
deviceIdstring是蓝牙设备 id
serviceIdstring是蓝牙特征值对应服务的 uuid
characteristicIdstring是蓝牙特征值的 uuid
valueArrayBuffer是蓝牙设备特征值对应的二进制值
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

错误

错误码错误信息说明
0ok正常
10000not init未初始化蓝牙适配器
10001not available当前蓝牙适配器不可用
10002no device没有找到指定设备
10003connection fail连接失败
10004no service没有找到指定服务
10005no characteristic没有找到指定特征值
10006no connection当前连接已断开
10007property not support当前特征值不支持此操作
10008system error其余所有系统上报的异常
10009system not supportAndroid 系统特有，系统版本低于 4.3 不支持 BLE

注意

  • 并行调用多次会存在写失败的可能性。
  • APP不会对写入数据包大小做限制，但系统与蓝牙设备会限制蓝牙4.0单次传输的数据大小，超过最大字节数后会发生写入错误，建议每次写入不超过20字节。
  • 若单次写入数据过长，ios 上存在系统不会有任何回调的情况（包括错误回调）。
  • 安卓平台上，在调用 notifyBLECharacteristicValueChange 成功后立即调用 writeBLECharacteristicValue 接口，在部分机型上会发生 10008 系统错误

示例代码

// 向蓝牙设备发送一个0x00的16进制数据
const buffer = new ArrayBuffer(1)
const dataView = new DataView(buffer)
dataView.setUint8(0, 0)
uni.writeBLECharacteristicValue(
  // 这里的 deviceId 需要在 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取
  deviceId,
  // 这里的 serviceId 需要在 getBLEDeviceServices 接口中获取
  serviceId,
  // 这里的 characteristicId 需要在 getBLEDeviceCharacteristics 接口中获取
  characteristicId,
  // 这里的value是ArrayBuffer类型
  value: buffer,
  success(res) 
    console.log('writeBLECharacteristicValue success', res.errMsg)
  
)

3、读取低功耗蓝牙设备的特征值的二进制数据值

uni.readBLECharacteristicValue(OBJECT)

注意：必须设备的特征值支持 read 才可以成功调用。

OBJECT 参数说明

属性类型默认值必填说明
deviceIdstring是蓝牙设备 id
serviceIdstring是蓝牙特征值对应服务的 uuid
characteristicIdstring是蓝牙特征值的 uuid
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

错误

错误码错误信息说明
0ok正常
10000not init未初始化蓝牙适配器
10001not available当前蓝牙适配器不可用
10002no device没有找到指定设备
10003connection fail连接失败
10004no service没有找到指定服务
10005no characteristic没有找到指定特征值
10006no connection当前连接已断开
10007property not support当前特征值不支持此操作
10008system error其余所有系统上报的异常
10009system not supportAndroid 系统特有，系统版本低于 4.3 不支持 BLE

注意

  • 并行调用多次会存在读失败的可能性。
  • 接口读取到的信息需要在 onBLECharacteristicValueChange 方法注册的回调中获取。

示例代码

// 必须在这里的回调才能获取
uni.onBLECharacteristicValueChange(function (characteristic) 
  console.log('characteristic value comed:', characteristic)
)
uni.readBLECharacteristicValue(
  // 这里的 deviceId 需要已经通过 createBLEConnection 与对应设备建立链接
  deviceId,
  // 这里的 serviceId 需要在 getBLEDeviceServices 接口中获取
  serviceId,
  // 这里的 characteristicId 需要在 getBLEDeviceCharacteristics 接口中获取
  characteristicId,
  success(res) 
    console.log('readBLECharacteristicValue:', res.errCode)
  
)

4、监听低功耗蓝牙连接状态的改变事件

uni.onBLEConnectionStateChange(CALLBACK)

包括开发者主动连接或断开连接，设备丢失，连接异常断开等等

CALLBACK 返回参数

属性类型说明
deviceIdstring蓝牙设备ID
connectedboolean是否处于已连接状态

示例代码 

uni.onBLEConnectionStateChange(function (res) 
  // 该方法回调中可以用于处理连接意外断开等异常情况
  console.log(`device $res.deviceId state has changed, connected: $res.connected`)
)

5、监听低功耗蓝牙设备的特征值变化事件

uni.onBLECharacteristicValueChange(CALLBACK)

必须先启用 notifyBLECharacteristicValueChange 接口才能接收到设备推送的 notification。

CALLBACK 返回参数

属性类型说明
deviceIdstring蓝牙设备 id
serviceIdstring蓝牙特征值对应服务的 uuid
characteristicIdstring蓝牙特征值的 uuid
valueArrayBuffer特征值最新的值

示例代码

// ArrayBuffer转16进度字符串示例
function ab2hex(buffer) 
  const hexArr = Array.prototype.map.call(
    new Uint8Array(buffer),
    function (bit) 
      return ('00' + bit.toString(16)).slice(-2)
    
  )
  return hexArr.join('')

uni.onBLECharacteristicValueChange(function (res) 
  console.log(`characteristic $res.characteristicId has changed, now is $res.value`)
  console.log(ab2hex(res.value))
)

6、订阅特征值

uni.notifyBLECharacteristicValueChange(OBJECT)

启用低功耗蓝牙设备特征值变化时的 notify 功能，订阅特征值。注意：必须设备的特征值支持 notify 或者 indicate 才可以成功调用。 另外，必须先启用 notifyBLECharacteristicValueChange 才能监听到设备 characteristicValueChange 事件

OBJECT 参数说明

属性类型默认值必填说明
deviceIdstring是蓝牙设备 id
serviceIdstring是蓝牙特征值对应服务的 uuid
characteristicIdstring是蓝牙特征值的 uuid
stateboolean是是否启用 notify
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

错误

错误码错误信息说明
0ok正常
10000not init未初始化蓝牙适配器
10001not available当前蓝牙适配器不可用
10002no device没有找到指定设备
10003connection fail连接失败
10004no service没有找到指定服务
10005no characteristic没有找到指定特征值
10006no connection当前连接已断开
10007property not support当前特征值不支持此操作
10008system error其余所有系统上报的异常
10009system not supportAndroid 系统特有，系统版本低于 4.3 不支持 BLE

注意

  • 订阅操作成功后需要设备主动更新特征值的 value，才会触发 uni.onBLECharacteristicValueChange 回调。
  • 安卓平台上，在调用 notifyBLECharacteristicValueChange 成功后立即调用 writeBLECharacteristicValue 接口，在部分机型上会发生 10008 系统错误

示例代码 

uni.notifyBLECharacteristicValueChange(
  state: true, // 启用 notify 功能
  // 这里的 deviceId 需要已经通过 createBLEConnection 与对应设备建立链接
  deviceId,
  // 这里的 serviceId 需要在 getBLEDeviceServices 接口中获取
  serviceId,
  // 这里的 characteristicId 需要在 getBLEDeviceCharacteristics 接口中获取
  characteristicId,
  success(res) 
    console.log('notifyBLECharacteristicValueChange success', res.errMsg)
  
)

7、获取蓝牙设备所有服务(service)

uni.getBLEDeviceServices(OBJECT)

OBJECT 参数说明

属性类型默认值必填说明
deviceIdstring是蓝牙设备 id
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

success 返回参数说明：

属性类型说明
servicesArray设备服务列表

res.services 的结构

属性类型说明
uuidstring蓝牙设备服务的 uuid
isPrimaryboolean该服务是否为主服务

错误

错误码错误信息说明
0ok正常
10000not init未初始化蓝牙适配器
10001not available当前蓝牙适配器不可用
10002no device没有找到指定设备
10003connection fail连接失败
10004no service没有找到指定服务
10005no characteristic没有找到指定特征值
10006no connection当前连接已断开
10007property not support当前特征值不支持此操作
10008system error其余所有系统上报的异常
10009system not supportAndroid 系统特有，系统版本低于 4.3 不支持 BLE

示例代码 

uni.getBLEDeviceServices(
  // 这里的 deviceId 需要已经通过 createBLEConnection 与对应设备建立链接
  deviceId,
  success(res) 
    console.log('device services:', res.services)
  
)

8、获取蓝牙设备的信号强度

uni.getBLEDeviceRSSI(OBJECT)

OBJECT 参数说明

属性类型默认值必填说明
deviceIdstring是蓝牙设备 id
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

9、获取蓝牙设备某个服务中所有特征值(characteristic)。

uni.getBLEDeviceCharacteristics(OBJECT)

uniapp实现蓝牙小票打印功能

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

组件： 组件例子

项目需要实现的是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，找不到特征值的情况，需要在失败回调中记录断点，继续发送后续的包

以上是关于uniapp微信小程序实现连接低功耗蓝牙打印功能的主要内容，如果未能解决你的问题，请参考以下文章

uni-k如何连接微信

断网了,如何让微信小程序,可以用蓝牙

uniapp微信小程序蓝牙的连接与应用

微信小程序蓝牙好用吗

wx.getBLEDeviceCharacteristics 微信小程序蓝牙 微信小程序热敏打印机

uniapp蓝牙连接+打印