欢迎使用 KPrinter UTS插件, 此插件适用于蓝牙热敏打印机，以下是说明及使用教程：

• 适用厂商：佳博、 启锐、汉印 等主流打印机
• 支持的指令类型：TSPL/TSC、 CPCL、ESC
• 支持平台：安卓、 iOS、鸿蒙-开发中
• 单位换算：200dip：1mm = 8dot、300dip：1mm = 12dot
• 插件下载地址

USBDevice 类型

// USB设备信息
export type USBDevice = {
   deviceName : string   // USB设备名称
   deviceId : string     // USB设备ID
   productName : string  // 产品名称
   productId : string  // 产品ID
   vendorId : string  // 供应商ID
   manufacturerName : string  // 生产商名称
   isConnect : boolean   // 是否连接
}

导入

import * as KPrinter from '@/uni_modules/kaka-KPrinter';

USB 接口说明

获取连接状态 - isConnect

const isConnect = KPrinter.isConnect();
uni.showToast({
    title: `连接状态: ${isConnect ? '已连接' : '未连接'}`
})

获取设备 - getUsbDeviceList

KPrinter.getUsbDeviceList((device) => {
    // device为usb设备对象(USBDevice)
});

连接USB设备- connectUSB

KPrinter.connectUSB('111'); // 参数为设备名称, device.deviceName

断开USB设备- connectUSB

KPrinter.disConnectUSB();

写入数据 - writeDataUSB

/*
    需要先构造指令，写入才有效
      如：
        KPrinter.cleanCmd()
        KPrinter.tscSelfTest()
        KPrinter.writeData();
*/ 
KPrinter.writeDataUSB();

USB 事件监听

USB连接状态监听

// usb连接监听
KPrinter.onUSBConnectStateChange({
    usbDeviceAttached: (device) => {
        uni.showToast({
            title: `插入USB设备`
        });
    },
    onSuccess: (device) => {
        uni.showToast({
            title: `USB 连接成功`
        });
    },
    onDisconnect: () => {
        uni.showToast({
            title: `USB 断开连接`
        });
    },
    onFail: (msg) => {
        uni.showToast({
            title: `USB连接失败: ${msg}`
        });
    }
});

USB数据回传监听

KPrinter.onDataReceive((data) => {
    let result = String.fromCharCode(...byte);
    console.log("收到USB数据: ", result, data);
});

USB数据写入完成监听

// 数据写入是否完成监听
KPrinter.onWriteComplete((isComplete) => {
    console.log("写入 " + (isComplete ? "成功" : "失败"));
});

指令使用说明

TSPL指令

CPCL指令

ESC指令