android 打印机服务,Android系统打印服务插件printservice开发

一 简介

从Android4.4开始，系统加入了打印相关的API，可以通过系统打印服务实现打印。对于需要使用打印功能的APP可参考官方教程接入打印服务。

这不是本文的内容，本文介绍打印机厂商如何使自己的打印机接入android，即编写自己的打印插件接入android打印服务。且仅介绍接入部分，与打印机如何连接不在本文范围之内。

系统打印服务框架代码位于android.printservice包中。系统并没有实现具体打印功能，需要打印机厂商制作插件接入系统打印服务之后，自行实现。本文基于Android API Reference和以下两个github上的开源项目研究而来。两个参考项目如下：

通过实验，初步实现了系统打印服务的接入(添加打印机)和模拟打印(将要打印的文件输出)。

二 主要类介绍PrintDocument 表示待打印文件，里面存放有文件的大小等信息和文件内容。

PrinterDiscoverySession 用于发现打印机，整个发现打印机和打印机状态更新的过程在该类里进行。

PrintJob 代表一个打印任务。

PrintService 接入系统打印的关键Service。

PrinterDiscoverySession 由 PrintService 创建，通过 onCreatePrinterDiscoverySession() 函数返回给系统。

PrintJob 由需要打印的APP创建，发送给 PrintService 。

PrintDocument 存放在 PrintJob 里面，被一同发过来。

三 打印服务插件的工作流程

1 打印机发现过程

当用户在设置里开启你的打印服务插件和进入系统打印服务界面时，系统会调用 PrinterDiscoverySession 里的 onStartPrinterDiscovery(List priorityList) 函数，通知你的插件查找打印机。具体查找方式需要自己实现，可能是查找USB接口，可能是搜索网络。系统只管结果，你通过调用其父类的 addPrinters() 方法将打印机添加进去。打印机是放在List数组里传入。

当用户离开上述打印插件的界面时，系统会调用 onStopPrinterDiscovery() 函数，表示插件可以停止寻找打印机了。

另外，在自定义的 addPrintersActivity 中，系统不会自动触发打印机寻找过程，需要自行处理。

2 打印机选择过程

当用户通过一些有打印功能的APP调用系统打印服务时，如果选择了你的插件的打印机，那么系统会调用 PrinterDiscoverySession 里的 onStartPrinterStateTracking(PrinterId printerId) 方法。这里系统主要希望得到打印机的 PrinterCapabilitiesInfo 和状态，里面包括打印机支持的纸张大小，以及色彩等详细功能参数。

比如：如果没有addMediaSize(PrintAttributes.MediaSize.ISO_A4, false)，那么用户就不能选择A4大小进行打印。后面的false表示是否设为默认值。

打印机有STATUS_BUSY、STATUS_IDLE、STATUS_UNAVAILABLE三种状态，只有打印机处于STATUS_IDLE时，系统才允许使用该打印机。

打印机参数直接体现在系统打印服务界面，只可以选择支持的参数，比如选择纸张的大小为A4。

同样，当用户离开该界面或者选择其他打印机时，系统会调用 onStopPrinterStateTracking(PrinterId printerId) 函数，来告诉插件不用再提供打印机的信息了。

3 打印过程

当用户在刚刚的系统打印服务界面点击右上角的打印按钮时，系统会调用打印机所属的 PrintService 里的 onPrintJobQueued(PrintJob printJob) 方法，插件需要处理该 PrintJob 。首先需要通过 PrintJob.isQueued() 判断，该PrintJob是否准备好打印，返回true代表可以打印。然后可以通过 PrintJob.getDocument() 获得要打印的文档，这里面的数据可以通过 PrintDocument.getData() 读取。开始打印的时候，调用PrintJob.start()标记开始状态。当打印成功时，调用 PrintJob.complete() 标记打印成功。或者打印失败时，调用 PrintJob.fail( String) 标记失败。

注意&#