更新记录

1.0.0（2025-11-07）

初始化

平台兼容性

uni-app(4.21)

uni-app x(4.07)

usb-printer

插件测试使用方法

1. 选择试用，绑定要试用的项目appid，

2. 选择后下载到对应的本地项目，

3. 按照文档 -》把插件引入项目（即 import {PrinterHelper} from "@/uni_modules/usb-printer" 需要先引入），

4. 发布-》云打包-》选择制作基座-》打包等基座制作完成

5. 运行 -》 运行到手机或模拟器-》运行到Androidapp基座-》选择使用自定义基座运行-》选择手机-》运行

6. 若之前手机安装过基座需要先卸载之前的基座

引入

import {PrinterHelper} from "@/uni_modules/usb-printer"

初始化(需要先加载 之后在使用之后代码)

PrinterHelper.initPrinter();

获取设备信息

var deices=PrinterHelper.getAllUseDeviceHp();// 返回所有设备  key为设备信息  

打开设备

PrinterHelper.open("key")  //参数为 获取设备信息的key

申请usb权限

PrinterHelper.reqPermission("key") // 返回所有设备  key为设备信息  

是否链接

var state=PrinterHelper.isConnect();// state 为是否链接

设备打印自检

var success= PrinterHelper.printSelfCheck();   // success 为true 表示发送成功 否则失败

字符转16进制

var hexStr=PrinterHelper.str2GbkBytes("这个是汉字转换为16进制")

发送16进制字符

//例子1 
var success= PrinterHelper.sendData("1B 69 01");  // success 为true 表示发送成功 否则失败  参数 1B 69 01 为切刀指令 
//例子2 
var success= PrinterHelper.sendData("1B 61 01");  // success 为true 表示发送成功 否则失败  参数 1B 61 01  居中模式

//例子3
var success= PrinterHelper.sendData(PrinterHelper.str2GbkBytes("这个是汉字转换为16进制")); // 打印文本  ‘这个是汉字转换为16进制’

打印二维码

PrinterHelper.printQrCode("test",3);// 参数1 是二维码内容  参数2 是二维码大小

usb 详情信息监听

uniappx

PrinterHelper.setUsbDetailsListener(function(data:string){

})

uniapp

PrinterHelper.setUsbDetailsListener(function(data){

})

打印机设备状态监听

uniappx

PrinterHelper.setUsbPrinterStateCallBack(function(type:number,msg:string){
        // type 为类型  msg 为信息描述

})

uniapp

PrinterHelper.setUsbPrinterStateCallBack(function(type,msg){
        // type 为类型  msg 为信息描述

})

收到打印机信息监听

uniappx

    PrinterHelper.setUsbReceiveAnyCallBack(function(data:string){

    })

uniapp

    PrinterHelper.setUsbReceiveAnyCallBack(function(data){

    })

usb 拔出插入监听

uniappx

PrinterHelper.setUsbStateChangeListener(function(i:number,data:string){
        // i 为0 表示设备插入   1 表示 设备拔出                   data为设备信息

})

uniapp

PrinterHelper.setUsbStateChangeListener(function(i,data){
        // i 为0 表示设备插入   1 表示 设备拔出                   data为设备信息

})

走纸

PrinterHelper.sendPrinterStep();

切纸

PrinterHelper.sendCutter();

学习

PrinterHelper.sendStudy();

连续纸

PrinterHelper.sendPieceToPiece();

标签纸每张切

PrinterHelper.sendCutPer();

标签纸每张切

PrinterHelper.sendCutInEnd();

黑标纸

PrinterHelper.sendBlack();

黑标偏移

 //offset 代表传感器读到黑标位置之后往前走纸 offset 距离，最大为 255（0xff），单位 mm，断电保存
PrinterHelper.setBlackMarkOffset(3);// 参数为0-255

获取打印机状态

PrinterHelper.checkoutPrinterState();

开发文档

UTS 语法 UTS API插件 UTS uni-app兼容模式组件 UTS 标准模式组件 Hello UTS