更新记录

1.0.1（2022-09-20）

20220916初始版本

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
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原生插件配置”->”云端插件“列表中删除该插件重新选择

1. connectPrinter 连接打印机
2. closeConnect 关闭连接
3. sendBytesData 发送数据
4. read 读取打印机返回的数据
5. initPrinter 初始化打印机
6. setFont 设置字体
7. setPrinter 设置打印格式
8. setPaperType 设置纸类型
9. setDensity 设置浓度
10. setPaperFeed 走纸
11. setPaperBack 退纸
12. printSelfCheck 打印自检页
13. printText 打印文本
14. printBarCode 打印条码
15. printImage 打印图片
16. printBigImage 打印图片（支持大图片）
17. printTable 打印表格
18. update 固件升级
19. searchGap 标签纸纸缝对齐
20. getPrinterStatus 获取打印机状态
21. setSensitivity 调节灵敏度
22. 缩小行间距（基于发送数据接口）
23. 设置符号语言（基于发送数据接口）

连接打印机

• 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 里没有数据