小程序开发指导(小程序开发指导手册)
互联网外包公司在提供企业定制开发小程序过程，由于业务需要，需要在应用中集成数据打印功能，由于项目是基于uni-app开发并发布成微信小程序。微信小程序和uni-app 的连接蓝牙API接口规范都是一样的，只不过微信小程序是挂载到wx 对象上，而uni-app则是挂载在了uni 对象上。使用uni-app开发的技术工程师可以直接使用微信的接口（前提是后期将项目发布到微信小程序平台）。
点击输入图片描述（最多30字）
在介绍微信小程序蓝牙连接打印之前，常州开发微信小程序公司https://www.dianzan51.com点个赞科技，简单梳理一下连接蓝牙打印进行打印操作的流程图。后续的开发将围绕流程图展开。
1 、初始化蓝牙模块。
打开蓝牙适配器
其他蓝牙相关 API 必须在 `uni.openBluetoothAdapter`[4] 调用之后使用。否则 API 会返回错误（errCode=10000）。
展开全文
uni.openBluetoothAdapter({
success(res) {
console.log(res)
2 、获取蓝牙适配器状态
理论上这步可以省略，不过为了确保程序不错意外，还是按部就班，在搜索蓝牙之前确保本机蓝牙状态正确。
3、搜索蓝牙设备
在「步骤3.2的成功回调函数」里调用uni.startBluetoothDevicesDiscovery 接口搜索附近可用的蓝牙设备。
uni.startBluetoothDevicesDiscovery({
success(res) {
console.log(res)
开始搜寻附近的蓝牙外围设备。（此操作比较耗费系统资源，请在搜索并连接到设备后调用 「**`uni.stopBluetoothDevicesDiscovery`**[5]」 方法停止搜索。）
4、 列出所有发现的蓝牙设备列表
在「步骤3.3 的成功回调」里面使用uni.getBluetoothDevices 接口获取蓝牙模块生效期间所有已发现的蓝牙设备。包括已经和本机处于连接状态的设备。由于蓝牙搜索需要一定过程，因此可以设置一定的延迟时间再执行uni.getBluetoothDevices 接口。
uni.startBluetoothDevicesDiscovery({
success: function(res) {
console.log(res);
setTimeout(function() {
uni.getBluetoothDevices({
success: function(res) {
var devices = [];
var num = 0;
for (var i = 0; i res.devices.length; ++i) {
if (res.devices[i].name != "未知设备") {
devices[num] = res.devices[i];
num++;
// 将发现的蓝牙设备存储起来，以下代码仅供参考
that.setData({
list: devices,
isScanning: false
uni.hideLoading();
uni.stopPullDownRefresh();
uni.stopBluetoothDevicesDiscovery({
success: function(res) {
console.log("停止搜索蓝牙");
}, 5000);
5、连接目标设备
连接低功耗蓝牙设备。若APP在之前已有搜索过某个蓝牙设备，并成功建立连接，可直接传入之前搜索获取的 deviceId 直接尝试连接该设备，无需进行搜索操作。
注意这里使用的是低功耗蓝牙设备接口
uni.createBLEConnection({
deviceId: e.currentTarget.dataset.title, // 设备id
success: function(res) {
console.log(res);
app.globalData.BLEInformation.deviceId = e.currentTarget.dataset.title;
that.getSeviceId();
},
fail: function(e) {
uni.showModal({
title: "提示",
content: "连接失败",
showCancel: false
console.log(e);
uni.hideLoading();
},
complete: function(e) {
console.log(e);
在连接目标设备过程需要注意如下几点：
1）、请保证尽量成对的调用 createBLEConnection 和 closeBLEConnection 接口。安卓如果多次调用 createBLEConnection 创建连接，有可能导致系统持有同一设备多个连接的实例，导致调用closeBLEConnection 的时候并不能真正的断开与设备的连接。
2）、蓝牙连接随时可能断开，建议监听 `uni.onBLEConnectionStateChange`[6] 回调事件，当蓝牙设备断开时按需执行重连操作。
3）、若对未连接的设备或已断开连接的设备调用数据读写操作的接口，会返回 10006 错误，建议进行重连操作。
6、操作打印机
操作打印机本质上就是通过uni.writeBLECharacteristicValue(OBJECT)接口向蓝牙设备写指令。
这里需要注意的是不同的打印机可能指令集不同。不过就我目前了解的情况来看市面上的小型蓝牙打印机主要分标签打印机和票据打印机两种。而这两种打印机指令集又有所区别。
界面参考和打印效果
以下界面由常州开发微信小程序公司点个赞科技，技术工程师实现蓝牙打印机店家提供的微信小程序源码反编译为uni-app项目而来。同时修复了源码中会导致蓝牙连接失败的错误，仅测试，代码可完整运行，可成功操作标签打印机和票据打印机实现打印功能。
