接口说明文档(PDF格式)下载地址:PrinterLibs For Android.pdf
打印机接口说明
一 概述
1 PrinterLibs是Android平台下控制Caysn打印机的jar库
2 PrinterLibs有以下几个公共类
A IO类
包括IO、BLEPrinting、BTPrinting、NETPrinting、USBPrinting
实现基本的Open、Close、Write、Read等功能
IOCallBack提供了Open和Close的回调接口、便于获取当前的连接状况
B 打印类
包括Pos、Label1
Pos类实现了诸如打印文本、打印条码、打印二维码、打印图片等功能
Label1类实现了标签打印功能,需要标签打印机支持
C 使用方法
Android代码片段:
Pos mPos = new Pos();
BTPrinting mBt = new BTPrinting();
mPos.Set(mBt);
mBt.SetCallBack(this);
之后启用异步调用:
public static class TaskOpenimplements Runnable
{
BTPrinting bt = null;
String address = null;
public TaskOpen(BTPrinting bt, String address)
{
this.bt = bt;
this.address = address;
}
@Override
public void run() {
// TODO Auto-generated method stub
bt.Open(address);
}
}
连接成功之后,调用相应的函数即可打印。
二 接口
IO
Write
Syntax
public int Write(byte[] buffer,int offset,int count)
Parameters
buffer
发送缓冲区
offset
从指定偏移开始发送数据
count
要发送的字节数
Return value
如果写入成功,返回成功写入的字节数、如果写入失败,返回-1
Remarks
IO类的Write函数为空实现,始终返回-1
Read
Syntax
public int Read(byte[] buffer,int offset,int count,int timeout)
Parameters
buffer
接收缓冲区
offset
从指定偏移开始存放收到的数据
count
要接收的字节数
timeout
超时毫秒时间
Return value
如果读取成功,返回成功读入的字节数、如果读取失败,返回-1。
Remarks
IO类的Read函数为空实现,始终返回-1
IsOpened
Syntax
public boolean IsOpened()
Parameters
Return value
如果以连接到打印机,返回true、否则,返回false
Remarks
IO类的IsOpened函数为空实现,始终返回false
IOCallBack
处理底层连接的4个类:
BLEPrinting BTPrinting NETPrinting USBPrinting
Open成功时,会调用OnOpen
Open失败时,会调用OnOpenFailed
Close或异常断开时,会调用OnClose
提示消息通过OnMessage传递,主要针对USBPrinting,该接口仅作调试使用
OnOpen
连接成功之后,会调用OnOpen
Syntax
void OnOpen()
Parameters
Return value
Remarks
OnOpenFailed
连接失败,会调用OnOpenFailed
Syntax
void OnOpenFailed()
Parameters
Return value
Remarks
OnClose
连接断开(主动断开或异常中断),会调用OnClose
Syntax
void OnClose()
Parameters
Return value
Remarks