打印机模块声明

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 打印区域的高度（标签高mm8）
出参： 无
返回值 0
补充说明

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

接口原型 int setPageModePrintArea(int x, int y, int dx, int dy);
接口功能 设置区域坐标和宽度、高度
参数说明 入参：x,y 一般是0,0,
dx 打印区域的宽度（标签宽mm8）
dy 打印区域的高度（标签高mm8）
出参： 无
返回值 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