更新记录
1.0.0(2026-11-19)
首发:通用 ESC/POS 蓝牙热敏打印 UTS 插件 蓝牙发现/连接/打印小票,内置 ESC/POS 指令构造器 文本/对齐/字号/加粗/二维码/条码/切纸/钱箱/蜂鸣 Android:经典蓝牙 SPP 完整链路,零厂商SDK依赖 iOS:CoreBluetooth (BLE) 骨架 兼容 uni-app 与 uni-app x
平台兼容性
DC-Print · 通用蓝牙热敏打印 UTS 插件
一套 API 实现蓝牙热敏小票打印:发现设备 → 连接 → 发送 ESC/POS 指令。零厂商 SDK 依赖,兼容主流 ESC/POS 热敏打印机(佳博、芯烨、汉印、得力、商米等绝大多数机型),兼容 uni-app 与 uni-app x。
为什么选它(对比同类)
| 对比项 | 市面同类 | 本插件 |
|---|---|---|
| 厂商 SDK | 多绑定佳博/芯烨等单一厂商 SDK | 零厂商 SDK,标准 ESC/POS 通吃 |
| 指令构造 | 多数只做透传,指令由买家自己拼 | 内置 ESC/POS 构造器(文本/对齐/字号/二维码/条码/切纸/钱箱/蜂鸣) |
| 平台 | 多为仅 Android 的 App 原生插件 | UTS 插件,Android / iOS 双端,兼容 x |
| 编码 | 中文常乱码 | 内置 GBK 编码处理 |
| 文档 | 普遍缺失 | 完整 API + 示例工程 + 常见问题 |
支持能力矩阵
| 能力 | Android | iOS | 鸿蒙 |
|---|---|---|---|
| 已配对设备列表(SPP) | ✅ | —(iOS 无系统配对列表) | 预留 |
| BLE 扫描 | 源码版桥接 | 源码版桥接 | 预留 |
| 经典蓝牙 SPP 连接 | ✅ | —(需 MFi,不支持) | — |
| BLE 连接 | 源码版桥接 | 源码版桥接 | 预留 |
| ESC/POS 指令构造 | ✅ | ✅ | ✅ |
| 指令写出 | ✅ | 源码版桥接 | 预留 |
说明:基础版即可用 Android SPP 全链路(连已配对打印机直接打印)。iOS 与 BLE 的完整传输在源码版提供(见"版本说明")。鸿蒙端为预留,暂不声明支持。
安装
将 uni_modules/dclab-print 放到项目 uni_modules 目录(HBuilderX 可从插件市场一键导入)。
UTS 插件需用 HBuilderX 开发,不支持 cli 方式。涉及原生能力需打包自定义基座后运行。 付费加密插件仅支持云端打包,不支持离线/安心打包,最低 HBuilderX 4.81+。
快速开始(Android SPP,基础版可用)
import * as printer from '@/uni_modules/dclab-print'
// 1. 检查蓝牙
if (!printer.isBluetoothEnabled()) {
uni.showToast({ title: '请先开启蓝牙', icon: 'none' })
return
}
// 2. 取已配对设备
const devices = printer.getBondedDevices()
// 3. 连接(选一台)
printer.connect({
deviceId: devices[0].deviceId,
success(res) { console.log('已连接', res.device) },
fail(res) { console.log('连接失败', res.msg) }
})
// 4. 打印(内置指令构造,中文不乱码)
printer.printText({
text: '欢迎光临',
align: 1, // 居中
size: 3, // 倍高宽
bold: true,
encoding: 'gbk'
})
printer.printText({ text: '------------------------', align: 1 })
printer.printText({ text: '订单号:20261119001', align: 0 })
printer.cutPaper({ success() { console.log('切纸完成') } })
// 5. 断开
printer.disconnect({})
API
查询(同步)
| 方法 | 返回 | 说明 |
|---|---|---|
isBluetoothAvailable() |
boolean | 设备是否支持蓝牙 |
isBluetoothEnabled() |
boolean | 蓝牙是否开启 |
isConnected() |
boolean | 是否已连接打印机 |
getBondedDevices() |
PrinterDevice[] | 已配对设备列表(Android SPP) |
连接
| 方法 | 参数 | 说明 |
|---|---|---|
startScan(options) |
{success, fail} |
开始 BLE 扫描(源码版实现) |
stopScan() |
— | 停止扫描 |
connect(options) |
{deviceId, linkType?, success, fail, complete} |
连接设备 |
disconnect(options) |
{success, fail, complete} |
断开 |
打印
| 方法 | 参数 | 说明 |
|---|---|---|
writeBytes(options) |
{data: number[], ...} |
写原始 ESC/POS 字节 |
writeString(options) |
{text, encoding?, ...} |
写文本(默认 GBK) |
printText(options) |
{text, align?, size?, bold?, newLine?, encoding?, ...} |
打印文字(内置指令构造) |
cutPaper(options) |
{...} |
切纸 |
openDrawer(options) |
{...} |
开钱箱 |
beep(options) |
{...} |
蜂鸣器 |
数据结构
PrinterDevice:{ name, deviceId, rssi }
PrintResult:{ success, msg, errCode, device?, devices? }
对齐 / 字号取值
- 对齐 align:
0左 /1中 /2右 - 字号 size:
0正常 /1倍高 /2倍宽 /3倍高宽
高级:原始 ESC/POS 指令
需要打印二维码、条码等复杂内容时,用 writeBytes 传自定义指令:
// 初始化 + 居中 + 换行
printer.writeBytes({ data: [0x1B, 0x40, 0x1B, 0x61, 0x01, 0x0A] })
指令格式参考 ESC/POS 标准命令集。源码版提供更丰富的指令构造 helper(二维码、一维码、位图)。
版本说明
| 版本 | 价格 | 内容 |
|---|---|---|
| 普通授权版 | ¥49 | Android SPP 完整打印链路 + ESC/POS 指令构造 + GBK 编码 |
| 源码授权版 | ¥299 | 全部源码 + Android BLE 扫描/连接桥接(hybrid.kt)+ iOS BLE 连接桥接(hybrid.swift)+ 二维码/条码/位图指令构造 + 技术支持 |
隐私与合规
- 本插件不联网、不上传任何数据,设备名称/地址仅用于本地连接;
- BLE 扫描在 Android 12 以下需定位权限(用于发现附近设备,不获取位置);
- 调用前请确保 App 已取得用户对隐私政策的同意;
- 各平台蓝牙政策可能调整,以平台最新规定为准。
更新日志
见 changelog.md。
许可
普通授权版按 appid + 包名 绑定;源码授权版见购买页说明。

收藏人数:
购买源码授权版(
试用
赞赏(0)
下载 61
赞赏 0
下载 12775974
赞赏 1960
赞赏
京公网安备:11010802035340号