更新记录
1.0.1(2022-09-20)
20220916初始版本
平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:5.1 - 10.0 | armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 | × |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios
注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择
- connectPrinter 连接打印机
- closeConnect 关闭连接
- sendBytesData 发送数据
- read 读取打印机返回的数据
- initPrinter 初始化打印机
- setFont 设置字体
- setPrinter 设置打印格式
- setPaperType 设置纸类型
- setDensity 设置浓度
- setPaperFeed 走纸
- setPaperBack 退纸
- printSelfCheck 打印自检页
- printText 打印文本
- printBarCode 打印条码
- printImage 打印图片
- printBigImage 打印图片(支持大图片)
- printTable 打印表格
- update 固件升级
- searchGap 标签纸纸缝对齐
- getPrinterStatus 获取打印机状态
- setSensitivity 调节灵敏度
- 缩小行间距(基于发送数据接口)
- 设置符号语言(基于发送数据接口)
连接打印机
-
connectPrinter
var sagePrt = uni.requireNativePlugin("sageinfo-print") export default { methods: { print() { console.log("print") sagePrt.connectPrinter(); sagePrt.setFont(0, 0, 1, 0, 0); sagePrt.setPrinter(2, 1); sagePrt.printText("停管中心停车小票" + "\r\n"); var content = "123458中文"; sagePrt.printBarCode(102, 0, 77, 5, content); sagePrt.setPrinter(1, 3); sagePrt.setPrinter(2, 0); sagePrt.closeConnect(); } } }
关闭连接
- closeConnect
发送数据
-
sendBytesData
函数原型 int sendBytesData(byte[] srcData) 功能描述 发送数据 参数描述 srcData 要发送的byte数组 返回类型 >0 成功发送到打印机的字节数 -1 未初始化打印 -2 srcData 为空或者srcData 里没有数据
读取打印机返回的数据
-
read
函数原型 int read(byte[] buffer) 功能描述 读取打印机返回的数据 参数描述 buffer 用于接收读到字节的数组 返回类型 >0 成功读到的字节数 -1 未初始化打印 -2 srcData 为空或者srcData 里没有数据
初始化打印机
-
initPrinter
函数原型 void initPrinter() 功能描述 初始化打印机 可以清除缓存 参数描述 无 返回类型 无
设置字体
-
setFont
函数原型 void setFont(int mCharacterType, int mWidth, int mHeight, int mBold, int mUnderline) 功能描述 设置字体 参数描述 1. mCharacterType 0 表示 12*24 字体大小,1 表示 9*16 字体大小,此设置临时有效 2. mWidth 倍宽,范围 0\~7 3. mHeight 倍高,范围 0\~7 4. mBold 0 不加粗,1 加粗 5. mUnderline 0 无 下划线,1 下划线 返回类型 无
设置打印格式
-
setPrinter
函数原型 void setPrinter(int command, int value) 功能描述 设置打印格式 参数描述 command = 0 - 打印并走纸 value 点行 command = 1 - 打印并走纸 value 字符行 command = 2 - 设置打印内容位置,Value 值可指定设置的具体位置 0 - 左对齐 1 - 居中对齐 2 - 右对齐
设置纸类型
-
setPaperType
函数原型 public int setPaperType(int paperType) 功能描述 设置纸类型 参数描述 1. paperType (0 热敏纸,1 标签纸,2 黑标纸) 返回类型 大于0成功
设置浓度
-
setDensity
函数原型 public int setDensity(int density) 功能描述 设置浓度 参数描述 1. density (0-4 浓度由浅到深) 返回类型 大于0成功
走纸
-
setPaperFeed
函数原型 public void setPaperFeed(int line) 功能描述 走纸 参数描述 1. line 走纸距离,单位mm 返回类型 无
退纸
-
setPaperBack
函数原型 public void setPaperBack(int line) 功能描述 退纸 参数描述 1. line 退纸距离,单位mm 返回类型 无
打印自检页
-
printSelfCheck
函数原型 public void printSelfCheck() 功能描述 打印自检页 参数描述 无 返回类型 无
打印文本
-
printText
函数原型 public void printText(String text) 功能描述 打印文本 参数描述 1. text 需要打印的文本内容(缓存不满一行需要在末尾加"\n",否则不打印) 返回类型 无
打印条码
-
printBarCode
函数原型 public int printBarCode(byte barcodeType, int param1, int param2, int param3, String content) 功能描述 打印条码 参数描述 1. barcodeType 条码类型 一维条码(UPC_A,UPC_E,JAN13,JAN8,CODE39,ITF,CODABAR,CODE93,CODE128) PDF417 DATAMATRIX QRCODE 2.param1 条码参数 条码横向宽度 ,2\<=n\<=6,默认为 2 每行字符数,1\<=n\<=30。 表示图形高,0\<=n\<=144(0: 自动选择) 表示图形版本号,1\<=n\<=30(0: 自动选择) 3.param2 条码参数 条码高度 1\<=n\<=255,默认 162 表示纠错等级,0\<=n\<=8 表示图形宽,8\<=n\<=144(param1 为0时,无效) 表示纠错等级,n=76,77,81,72(L:7%,M:15%,Q:25%,H:30%) 4.param3 条码参数 条码注释位置,0 不打印,1 上方,2 下方,3 上下方均有 表示纵向放大倍数 表示纵向放大倍数 表示纵向放大倍数 5.content 条码数据 返回类型 大于0成功
打印二维码
-
printQrCode
函数原型 public int printQrCode(int param1, int param2, int param3, String content) 功能描述 打印二维码 参数描述 1.param1 参数 表示图形版本号,1\<=n\<=30(0: 自动选择) 2.param2 参数 表示纠错等级,n=76,77,81,72(L:7%,M:15%,Q:25%,H:30%) 3.param3 参数 表示纵向放大倍数 4.content 二维码数据 返回类型 大于0成功
打印图片
-
printImage
函数原型 public void printImage(Bitmap bitmap, PrinterConstants.PAlign alignType, int left, boolean isCompressed) 功能描述 打印图片 参数描述 1. bitmap 单色位图 2. alignType 对齐方式 3. left 偏移 alignType为NONE时有效 4. isCompressed 是否压缩 返回类型 无 -
printBigImage
函数原型 public void printBigImage(Bitmap bitmap, PrinterConstants.PAlign alignType, int left, boolean isCompressed) 功能描述 打印图片(支持大图片) 参数描述 1. bitmap 单色位图 2. alignType 对齐方式 3. left 偏移 alignType为NONE时有效 4. isCompressed 是否压缩 返回类型 无
打印表格
-
printTable
函数原型 public void printTable(Table table) 功能描述 打印表格 参数描述 1. table 表格 返回类型 无 -
printTable
函数原型 public void printTable(String column, String regularExpression, int[] columnWidth, ArrayList\<String> rows) 功能描述 打印表格 参数描述 1. column 表头,列名,以regularExpression字符分隔 2.regularExpression 表内分隔符 3.columnWidth 每列列宽,字符个数 4.rows list集合每一条数据代表一行(格式与表头一致) 返回类型 无
标签纸纸缝对齐
-
searchGap
函数原型 public void searchGap() 功能描述 标签纸纸缝对齐,执行后将定位到当前纸纸缝位置(仅标签纸模式有效) 参数描述 无 返回类型 无
获取打印机状态
-
getPrinterStatus
函数原型 public int getPrinterStatus() 功能描述 获取打印机状态 参数描述 无 返回类型 0-正常、1-缺纸、3-通讯异常
调节灵敏度
-
setSensitivity
函数原型 public void setSensitivity(int sensitivity) 功能描述 调节打印机走标签纸的灵敏度 参数描述 1. sensitivity 灵敏度值(参数范围:十进制的1-33,默认值为20。如果走纸走过了缝隙就设置大一些,如果走纸没走到缝隙就停止了就设置小一些) 返回类型 无
缩小行间距(基于发送数据接口)
-
sendBytesData
函数原型 int sendBytesData(byte[] srcData) 功能描述 缩小行间距 参数描述 srcData 要发送的byte数组:1b 33 00 返回类型 >0 成功发送到打印机的字节数 -1 未初始化打印 -2 srcData 为空或者srcData 里没有数据
设置符号语言(基于发送数据接口)
-
sendBytesData
函数原型 int sendBytesData(byte[] srcData) 功能描述 设置打印机语言类型,用于能够打印不同的中英文符号,设置一次即可生效 参数描述 srcData 要发送的byte数组。英文:1F 11 1F 18 00 1F 1F 中文:1F 11 1F 18 01 1F 1F 返回类型 >0 成功发送到打印机的字节数 -1 未初始化打印 -2 srcData 为空或者srcData 里没有数据