打印机模块声明

1 模块说明

用于操作打印机设备。

2 包路径

com.histonepos.npsdk.printer

3 AIDL文件名

IPrinterService.aidl

4 接口清单

4.1 打印机配置(setConfig)

接口原型 void setConfig(Bundle data)
接口功能 打印机配置
参数说明 入参:data 设置打印机宽度等
出参: 无
返回值 void

4.2 获取状态(checkStatus)

接口原型 void checkStatus()
接口功能 获取打印机状态
参数说明 入参: 无
出参: 无
返回值 非负数(>=0), 状态正常
负数( < 0),具体参见jar包中PrinterConsts中的常量

4.3 开钱箱(openCashBox)

接口原型 void openCashBox()
接口功能 开钱箱
参数说明 入参: 无
出参: 无
返回值 void

4.4 获取打印机描述(getDescriptions)

接口原型 Bundle getDescriptions()
接口功能 获取打印机描述信息
参数说明 入参: 无
出参: 无
返回值 Bundle 封装打印机描述信息的bundle
补充说明 预留接口

4.5 扩展指令集(addCommand)

接口原型 Void addCommand(byte[] data)
接口功能 扩展指令集
参数说明 入参:data 指令
出参: 无
返回值 void
补充说明 通过直接发送ESC/POS指令来控制打印机

4.6 切纸(addCut)

接口原型 void addCut()
接口功能 切纸
参数说明 入参: 无
出参: 无
返回值 void

4.7 按行走纸(addFeedLine)

接口原型 void addFeedLine(int line)
接口功能 按行走纸
参数说明 入参: line 行数
出参: 无
返回值 void

4.8 像素走纸(addFeedDots)

接口原型 void addFeedDots(int dots)
接口功能 按点走纸
参数说明 入参: dots 走纸点数
出参: 无
返回值 void

4.9 双倍字体(addTextSizeDouble)

接口原型 void addTextSizeDouble()
接口功能 双倍字体
参数说明 入参: 无
出参: 无
返回值 void

4.10 正常字体(addTextSizeNormal)

接口原型 void addTextSizeNormal()
接口功能 常规字体
参数说明 入参: 无
出参: 无
返回值 void

4.11 打印文本(addText)

接口原型 void addText(String data, int alignment)
接口功能 打印文本
参数说明 入参:data 打印内容
   alignment对齐方式 0:左对齐
             1:居中
            2:右对齐
出参:无
返回值 void

4.12 表格形式打印文本(addTextsAutoWrap)

接口原型 void addTextsAutoWrap(in int[] weights, in int[] aligns, in String[] datas)
接口功能 以表格形式打印文本
参数说明 入参:weights 各列的宽度占比
出参: 无
返回值 void
补充说明 列宽比须为最简整数比,且各值加和等于2或者4或者8。如,1.0:1.0:2.0”,否则抛出IllegalArgumentException

4.13 设置对齐方式(setAlign)

接口原型 void setAlign(int align)
接口功能 对图片,条码,二维码等设置对齐方式
参数说明 入参:align 对齐方式 0:居左
          1:居中
          2:居左
出参:无
返回值 void
补充说明 如未调用该接口对图片,条码,二维码进行对齐方式设置,则默认居中打印。

4.14 打印图片(addImage)

接口原型 void addImage(in Bitmap data)
接口功能 打印图片
参数说明 入参:data bitmap位图
出参: 无
返回值 void
补充说明 如果未调用setAlign设置对齐方式,则默认居中打印。

4.15 打印QR码(addQRCode)

接口原型 void addQRCode(String qrcode,int mode)
接口功能 打印QR码
参数说明 入参: qrcode QR码内容
出参: 无
返回值 void
补充说明 如果未调用setAlign设置对齐方式,则默认居中打印。

4.16 打印条码(addBarcode)

接口原型 void addBarcode(String barcode)
接口功能 打印条码
参数说明 入参: barcode 条码内容
出参: 无
返回值 void
补充说明 如果未调用setAlign设置对齐方式,则默认居中打印。

4.17 开始构建布局(beginTranscation)

接口原型 void beginTranscation()
接口功能 开始构建一个小票布局
参数说明 入参: 无
出参: 无
返回值 void

4.18 结束构建布局(endTranscation)

接口原型 int endTranscation()
接口功能 结束构建小票布局
参数说明 入参: 无
出参: 无
返回值 返回 transId, 该笔小票的id
补充说明 将transId传入commit(int transId)方法,开始打印

4.19 提交打印(commit)

接口原型 int commit(int transId)
接口功能 提交打印数据,开始打印
参数说明 入参 transId - 小票的id,即endTranscation()的返回值
出参: 无
返回值 0:提交成功
1:提交失败

4.20 注册状态监听器(registerStatusListener)

接口原型 void registerStatusListener(IPrinterStatusListener statusChange)
接口功能 注册打印机状态变化的监听器
参数说明 入参:statusChange 回调接口
出参: 无
返回值 void

4.21 取消注册状态监听器(unRegisterStatusListener)

接口原型 void unRegisterStatusListener()
接口功能 取消注册打印机状态变化的监听器
参数说明 入参:无
出参: 无
返回值 void

注意:以下接口只适用于标签打印机,普通热敏打印机请勿调用

4.22 获取支持的最大区域(getPageModeMaxArea)

接口原型 String getPageModeMaxArea();
接口功能 取消注册打印机状态变化的监听器
参数说明 入参:无
出参: 无
返回值 以逗号分隔的两个数值dx,dy,返回“0,0”时说明此型号没有适配页模式
补充说明

4.23 设置区域坐标和宽度、高度(setPageModePrintArea)

接口原型 int setPageModePrintArea(int x, int y, int dx, int dy);
接口功能 设置区域坐标和宽度、高度
参数说明 入参:x,y 一般是0,0,
dx 打印区域的宽度(标签宽mm8)
dy 打印区域的高度(标签高mm
8)
出参: 无
返回值 0
补充说明

4.23 设置区域坐标和宽度、高度(setPageModePrintArea)

接口原型 int setPageModePrintArea(int x, int y, int dx, int dy);
接口功能 设置区域坐标和宽度、高度
参数说明 入参:x,y 一般是0,0,
dx 打印区域的宽度(标签宽mm8)
dy 打印区域的高度(标签高mm
8)
出参: 无
返回值 0
补充说明

4.24 设置文本打印方向(setPageModeDirection)

接口原型 int setPageModeDirection (int direction);
接口功能 设置文本打印方向,用于文本打印
参数说明 入参:Direction
0 – 从左到右
1- 从下到上
2- 从右到左
3- 从上到下
出参: 无
返回值 0
补充说明

4.25 设置文本打印绝对位置(setPageModeVerticalPostion)

接口原型 Int setPageModeVerticalPostion (int dots);
接口功能 设置文本打印绝对位置(与打印方向同向,y方向)
参数说明 入参:Dots (毫米mm*8)
出参: 无
返回值 0
补充说明

4.26 设置文本打印绝对位置(setPageModeHorizontalPostion)

接口原型 Int setPageModeHorizontalPostion (int dots);
接口功能 设置文本打印绝对位置(与打印方向垂直向,x方向)
参数说明 入参:Dots (毫米mm*8)
出参: 无
返回值 0
补充说明

4.27 进入标签模式及标签打印、进纸(pageModePrint)

接口原型 Int pageModePrint (int pm);
接口功能 进入标签模式及标签打印、进纸
参数说明 入参:pm
0 进入标签模式且初始化参数
1 打印并保存标签(或进一张标签)
2 打印并清除数据
3 清空数据
出参: 无
返回值 0
补充说明 首先要进入标签模式(初始化),设置标签区域,添加文本或addimage位图数据(推荐位图打印)、打印

4.28 校验标签(pageModeCheckLabel)

接口原型 Int pageModePrint (int pm);
接口功能 校验标签
参数说明 入参:无
出参: 无
返回值 0
补充说明 第一次使用标签打印机或者新类型的纸(比如6040换成6030)需要校验纸张,让打印机识别纸张,否则会导致进纸不正确
作者:admin  创建时间:2022-03-18 11:39
最后编辑:admin  更新时间:2024-06-18 09:08