当前位置：首页 > news >正文

微信小程序调用蓝牙打印机教程（TSPL命令）

news 2025/8/30 8:13:13

准备工作

确保打印机支持蓝牙连接并已配对。微信小程序需申请蓝牙相关权限，在app.json中配置：

{"requiredPermissions": ["bluetooth"]
}

初始化蓝牙模块

在小程序页面中初始化蓝牙适配器，检查蓝牙是否可用：

wx.openBluetoothAdapter({success(res) {console.log('蓝牙适配器初始化成功');},fail(err) {console.error('初始化失败', err);}
});

搜索蓝牙设备

调用startBluetoothDevicesDiscovery搜索附近的蓝牙设备：

wx.startBluetoothDevicesDiscovery({services: ['0000FF00-0000-1000-8000-00805F9B34FB'], // 打印机服务UUIDsuccess(res) {console.log('开始搜索设备');}
});

监听发现设备事件

通过onBluetoothDeviceFound监听发现的设备：

wx.onBluetoothDeviceFound((res) => {const devices = res.devices;if (devices.length > 0) {console.log('发现设备', devices);}
});

连接打印机

选择目标设备后，建立蓝牙连接：

wx.createBLEConnection({deviceId: '目标设备ID',success(res) {console.log('连接成功');}
});

获取打印机服务

连接成功后，获取服务UUID：

wx.getBLEDeviceServices({deviceId: '目标设备ID',success(res) {const services = res.services;console.log('服务列表', services);}
});

获取特征值

找到服务的特征值（用于写入数据）：

wx.getBLEDeviceCharacteristics({deviceId: '目标设备ID',serviceId: '服务UUID',success(res) {const characteristics = res.characteristics;console.log('特征值列表', characteristics);}
});

发送TSPL指令

通过writeBLECharacteristicValue发送TSPL打印指令：

// 示例：打印文本
const tsplCommand = 'TEXT 100,100,"0",0,1,1,"Hello World"\n';
const buffer = new ArrayBuffer(tsplCommand.length);
const dataView = new Uint8Array(buffer);
for (let i = 0; i < tsplCommand.length; i++) {dataView[i] = tsplCommand.charCodeAt(i);
}wx.writeBLECharacteristicValue({deviceId: '目标设备ID',serviceId: '服务UUID',characteristicId: '特征值UUID',value: buffer,success(res) {console.log('指令发送成功');}
});

断开连接

打印完成后断开蓝牙连接：

wx.closeBLEConnection({deviceId: '目标设备ID',success(res) {console.log('断开连接成功');}
});

常见TSPL指令示例

打印文本
TEXT x,y,"font",rotation,x-multi,y-multi,"content"
示例：TEXT 100,200,"0",0,1,1,"测试文本"
打印条形码
BARCODE x,y,"code_type",height,human_readable,rotation,"content"
示例：BARCODE 100,300,"128",50,1,0,"123456"
打印二维码
QRCODE x,y,error_correction_level,width,"content"
示例：QRCODE 100,400,"H",5,"https://example.com"
设置标签大小
SIZE width_mm,height_mm
示例：SIZE 50,30
打印指令结束
PRINT 1,1