PrinterLibs_For_Android_en_US_201700630

### PrinterLibs_For_Android_en_US_201700630 #### 概述 本文档为Caysn打印机Android开发包接口说明文档的英文版本，旨在为开发者提供一套全面且易于使用的API来控制打印机在Android平台上的工作流程。通过本文档，开发者可以了解如何使用提供的接口进行打印操作，包括基本的读写操作、状态查询以及更高级的打印功能。 #### 接口介绍 PrinterLibs是用于Android平台控制打印机的一组jar库。它包含了一系列公共类目，这些类目被设计来实现打印机的基本控制功能以及高级打印特性。 ##### A. IO IO类目包含了以下几种打印方式： - **BLEPrinting**：蓝牙低功耗打印。 - **BTPrinting**：传统蓝牙打印。 - **NETPrinting**：网络打印。 - **USBPrinting**：USB打印。 这些类目实现了打印机的基本操作，如打开连接（Open）、关闭连接（Close）、写入数据（Write）和读取数据（Read）。此外，`IOCallBack`提供了打开和关闭连接的回调接口，方便开发者获取连接状态。 ##### B. Printing Printing类目提供了更丰富的打印功能支持，主要包括： - **Pos**：实现了一些基础打印功能，如文本打印、条形码打印、二维码打印和图片打印等。 - **Label1**：实现了标签打印功能，并需要打印机硬件的支持。 接下来，我们将详细介绍这些接口的具体功能和使用方法。 ### 详细接口说明 #### 1. IO - **Open**：打开打印机连接。 - **Close**：关闭打印机连接。 - **Write**：向打印机写入数据。 - **Read**：从打印机读取数据。 - **IsOpened**：检查打印机是否已打开。 - **SetCallBack**：设置回调函数，以便在特定事件发生时接收通知。 #### 2. BTPrinting (蓝牙打印) - **Listen**：监听蓝牙设备。 - **Open**：打开蓝牙连接。 - **Close**：关闭蓝牙连接。 - **Write**：向蓝牙打印机写入数据。 - **Read**：从蓝牙打印机读取数据。 - **SkipAvailable**：跳过可用的数据。 - **IsOpened**：检查蓝牙打印机是否已打开。 - **SetCallBack**：设置蓝牙打印机的回调函数。 #### 3. BLEPrinting (蓝牙低功耗打印) - **Open**：打开蓝牙低功耗连接。 - **Close**：关闭蓝牙低功耗连接。 - **Write**：向蓝牙低功耗打印机写入数据。 - **Read**：从蓝牙低功耗打印机读取数据。 - **SkipAvailable**：跳过可用的数据。 - **IsOpened**：检查蓝牙低功耗打印机是否已打开。 - **SetCallBack**：设置蓝牙低功耗打印机的回调函数。 #### 4. NETPrinting (网络打印) - **Open**：打开网络连接。 - **Close**：关闭网络连接。 - **Write**：向网络打印机写入数据。 - **Read**：从网络打印机读取数据。 - **SkipAvailable**：跳过可用的数据。 - **IsOpened**：检查网络打印机是否已打开。 - **SetCallBack**：设置网络打印机的回调函数。 #### 5. USBPrinting (USB打印) - **Open**：打开USB连接。 - **Close**：关闭USB连接。 - **Write**：向USB打印机写入数据。 - **Read**：从USB打印机读取数据。 - **SkipAvailable**：跳过可用的数据。 - **IsOpened**：检查USB打印机是否已打开。 - **SetCallBack**：设置USB打印机的回调函数。 #### 6. Pos (位置打印) - **POS_PrintPicture**：打印图片。 - **POS_S_TextOut**：安全模式下输出文本。 - **POS_TextOut**：普通模式下输出文本。 - **POS_S_SetBarcode**：安全模式下设置条形码。 - **POS_S_SetQRcode**：安全模式下设置二维码。 - **POS_DoubleQRcode**：打印两个二维码。 - **POS_FeedLine**：进纸。 - **POS_S_Align**：安全模式下对齐。 - **POS_SetLineHeight**：设置行高。 - **POS_Reset**：重置打印机。 - **POS_SetMotionUnit**：设置移动单位。 - **POS_S_SetAreaWidth**：安全模式下设置区域宽度。 - **POS_CutPaper**：切纸。 - **POS_Beep**：发出蜂鸣声。 - **POS_KickDrawer**：踢出抽屉。 - **POS_SetPrintSpeed**：设置打印速度。 - **POS_QueryStatus**：查询打印机状态。 - **POS_RTQueryStatus**：实时查询打印机状态。 - **POS_TicketSucceed**：票据打印成功。 #### 7. Label (标签打印) - **PageBegin**：开始一页。 - **PageEnd**：结束一页。 - **PagePrint**：打印一页。 - **PageFeed**：进纸。 - **DrawPlainText**：绘制纯文本。 - **DrawLine**：绘制直线。 - **DrawBox**：绘制盒子。 - **DrawRectangel**：绘制矩形。 - **DrawBarcode**：绘制条形码。 - **DrawQRCode**：绘制二维码。 - **DrawBitmap**：绘制位图。 - **Page**：页面打印。 - **SetPrintArea**：设置打印区域。 - **DrawText**：绘制文本。 - **DrawTextAutoNewLine**：自动换行绘制文本。 - **DrawTextMultiLine**：多行文本绘制。 - **DrawLine**：绘制直线。 - **DrawBox**：绘制盒子。 - **DrawRect**：绘制矩形。 - **DrawBitmap**：绘制位图。 - **DrawQRCode**：绘制二维码。 - **DrawBarcode**：绘制条形码。 ### 总结 PrinterLibs为Android平台提供了一套完整的打印机控制解决方案，涵盖了从基本的读写操作到高级的打印功能。通过本文档，开发者可以轻松地集成打印机功能到自己的应用程序中，实现各种复杂的打印需求。无论是蓝牙、网络还是USB打印机，本库都提供了相应的接口支持，极大地简化了开发过程。