更新记录

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 + 包名 绑定;源码授权版见购买页说明。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

Android:使用经典蓝牙SPP与BLE需要BLUETOOTH、BLUETOOTH_ADMIN、BLUETOOTH_SCAN、BLUETOOTH_CONNECT权限;BLE扫描在Android12以下还需ACCESS_FINE_LOCATION(用于发现蓝牙设备,不获取地理位置)。均在AndroidManifest.xml声明,运行时由宿主申请。iOS:需NSBluetoothAlwaysUsageDescription,已在Info.plist声明。

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

采集数据:附近蓝牙设备名称与地址/MAC,用于设备列表展示与连接,属蓝牙协议层公开广播信息。发送服务器地址:无,不含任何网络请求,不上传设备信息或打印内容,通信仅在宿主设备与打印机本地进行。用途:供宿主App发现蓝牙打印机、建立连接并发送打印指令。

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无。本插件不包含任何广告,无广告代码、无广告SDK、无广告展示,不涉及广告表达方式与展示频率。

暂无用户评论。