CaysnPrinter开发包接口说明文档 - PrinterLibs For Android

接口说明文档(PDF格式)下载地址：PrinterLibs For Android.pdf

打印机接口说明

 

一 概述 3

二 接口 4

IO 4

Write 4

Read 5

IsOpened 6

IOCallBack 7

OnOpen 7

OnOpenFailed 8

OnClose 9

OnMessage 10

BTPrinting 11

Open 11

Listen 12

Close 13

SetWritePackageSize 14

SetBaudrate 15

Write 16

Read 17

SkipAvailable 18

IsOpened 19

SetCallBack 20

BLEPrinting 21

Open 21

Close 22

Write 23

Read 24

SkipAvailable 25

IsOpened 26

SetCallBack 27

NETPrinting 28

Open 28

Close 29

Write 30

Read 31

SkipAvailable 32

IsOpened 33

USBPrinting 34

Open 34

Close 35

Write 36

Read 37

SkipAvailable 38

IsOpened 39

Pos 40

Set 40

GetIO 41

POS_PrintPicture 42

POS_PrintBWPic 43

POS_S_TextOut 44

POS_S_SetBarcode 45

POS_S_SetQRcode 47

POS_FeedLine 48

POS_S_Align 49

POS_SetLineHeight 50

POS_Reset 51

POS_SetMotionUnit 52

POS_SetCharSetAndCodePage 53

POS_S_SetAreaWidth 55

POS_CutPaper 56

POS_Beep 57

POS_KickDrawer 58

POS_QueryStatus 59

POS_QueryStatus 60

POS_TicketSucceed 62

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

一 概述

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