更新记录

0.1.1（2025-04-05）

• chore： 更新文档

0.1.0（2025-04-05）

• feat：增加连接判断权限

0.0.9（2025-04-03）

• feat：增加打包连接间隔

平台兼容性

uni-app

uni-app x

lime-printer 打印

• 使用UTS通过蓝牙、网络、USB连接打印机，向打印机发送打印指令打印(小票、标签)，目前只测了安卓蓝牙(TSC)
• 插件做到蓝牙后，打印机就还回去了没有机会测试网络和USB。如果你有这条件可以完善一下

文档

printer

安装

在插件市场导入，引入插件后自定义基座

使用

典型工作流程

初始化 → 搜索设备 → 选择设备 → 连接 → 发送指令 → 打印

蓝牙连接

// 1. 引入插件
import { usePrinter,  SearchOption, ConnectOption, PrintOption} from '@/uni_modules/lime-printer'

type Bluetooth = {
    name : string,
    deviceId : string
}

const printer = usePrinter()
const bluetooths = ref<Bluetooth[]>([])
// 2. 初始化蓝牙连接
printer.setUpConnection('bluetooth')

// 3. 搜索设备
const search = () => {
    bluetooths.value = []
    printer.search({
        success: () => console.log('开始搜索'),
        fail: err => console.error('搜索失败', err)
    } as SearchOption)
}

// 4. 监听搜索结果
printer.onSearch((bt) => {
    console.log('发现设备:', device.deviceId);
    const bluetooth:Bluetooth = {
        name : bt.name,
        deviceId : bt.deviceId
    }
    bluetooths.value.push(bluetooth)
})

// 5. 连接打印机（替换为实际设备ID）
const connect = () => {
    printer.connect({
        deviceId: '60:6E:41:96:33:CD',
        success(res) {
            console.log('连接成功')
        },
        fail(err) {
            console.log('连接失败')
        }
    } as ConnectOption)
}

// 6. 发送打印指令
const print = () => {
    //TSC
    printer.print({
        data: "SIZE 40 mm, 30 mm\r\n" +
        "GAP 3 mm, 0 mm\r\n" +
        "DIRECTION 1,0\r\n" +
        "REFERENCE 0,0\r\n" +
        "SET TEAR 1\r\n" +
        "CLS\r\n" +
        "TEXT 20,10, \"test.ttf\",0,1,1,\"first line!\"\r\n" +
        "TEXT 20,51, \"test.ttf\",0,1,1,\"second line!\"\r\n" +
        "TEXT 20,92, \"test.ttf\",0,1,1,\"third line!\"\r\n" +
        "TEXT 20,133, \"test.ttf\",0,1,1,\"firth line!\"\r\n" +
        //"BARCODE 40,165,\"128\",40,1,0,2,2,\"1234567890\"\r\n" +
        "QRCODE 40,165,L, 4, A, 0,\"abcdefg\"\r\n" +
        "PRINT 1,2\r\n"
    } as PrintOption)
}

网络

使用方法同蓝牙一样,未经过测试

printer.setUpConnection('net')

USB

使用方法同蓝牙一样,未经过测试

printer.setUpConnection('usb')

API

search(option: SearchOption)

功能：扫描周边设备

interface SearchOption {
  allowDuplicatesKey?: boolean; // 是否允许重复上报
  interval?: number;           // 上报间隔(ms)
  services?: string[];         // 过滤服务UUID列表
  success?: (res: PrinterError) => void;
  fail?: (res: PrinterError) => void;
  complete?: (res: PrinterError) => void;
}

connect(option: ConnectOption)

功能：连接指定设备

interface ConnectOption {
  deviceId?: string;  // 目标设备ID
  autoReconnect?: boolean; // 是否启用自动重连
  maxReconnectAttempts?: number; //最大重连次数（默认3次
  success?: (res: PrinterError) => void;
  fail?: (res: PrinterError) => void;
  complete?: (res: PrinterError) => void;
}

printer.connect({
  deviceId: 'XX:XX:XX:XX:XX',
  success: () => {/* 连接成功处理 */}
});

print(option: PrintOption)

功能：发送打印数据

interface PrintOption {
  data: string;  // 要发送的数据
  deviceId?: string;  // 重新连接打印机的ID,如果不设置则默认上次的
  delay?: number;  // 重新连接打印机的间隔
  success?: (res: PrinterError) => void;
  fail?: (res: PrinterError) => void;
  complete?: (res: PrinterError) => void;
}

onSearch

功能：监听扫描到的设备

printer.onSearch((device) => {
  console.log(`发现设备 - 名称: ${device.name}, ID: ${device.deviceId}`);
});

stop

功能：停止搜索

disconnect

功能：断开设备