iOS打印 AirPrint 及普通打印机如何适配

1. 什么是AirPrint

AirPrint 是可以让应⽤用软件通过 Apple 的⽆无驱动程序打印体系结构，创建⽆无损打印输出的 Apple 技术。

2. 使⽤用要求

要使⽤用 AirPrint，您需要下列列任⼀一装有最新版本的 iOS 的设备:

iPad(所有机型)

iPhone(3GS 或更更新机型)

iPod touch(第 3 代或更更新机型)

还需要一台本⽂文中列列出的⽀支持 AirPrint 的打印机。AirPrint 不⽀持下文中未列出的打印机。

不支持AirPrint的打印机适配，如何设置实现airprint无线打印。

3. 可以打印的内容

3.1 an array of ready-to-print images and PDF documents: ⼀一组图⽚片⽂文件和PDF⽂文件。

3.2 a single image or PDF document: ⼀一张图⽚片或是⼀一个pdf文件。

3.3 an instance of any of the built-in print formatter classes:打印格式化者的实例例。(简单⽂文本，html⽂文档，某些View显示的内容)。

3.4 a custom page renderer: ⾃自定义⻚页渲染者

4. 关于AirPrint的API

图4-1

AirPrint相关类

UIPrintInteractionController 属性：

UIPrintInfo *printInfo: 打印任务的信息。

UIPrintPaper * printPaper : 打印内容的区域。

delegate：遵守UIPrintInteractionControllerDelegate 协议的代理

UIPrintInteractionController

UIPrintInteractionController是IOS中央印刷类。它的共享实例代表一个打印作业。打印作业，包括其印刷相关的信息和选项，如输出类型，作业名称，纸张大小和方向，要打印的内容。

printInfo UIPrintInfo：之前所述的打印任务的配置。

printPaper UIPrintPaper：纸张类型的物理和打印尺寸的一个简单的类型描述；除了专门的应用程序，这将由 UIKit 处理。

showsNumberOfCopies Bool：当值为 true 时，让用户选择拷贝的份数。

showsPageRange Bool：当值为 true 时，让用户从打印源中选择一个子范围。这只在多页内容时有用，它默认关闭了图像。

showsPaperSelectionForLoadedPapers Bool：当值为 true 并且所选择的打印机有多个纸张选项时，用户界面将让用户选择用于打印的纸张。

UIPrintInfo

一个UIPrintInfo对象封装了有关打印作业的信息，包括打印机标识，作业名称，输出类型（照片，正常，灰阶），方向（纵向或横向），和任何选定的双工模式。

jobName String：此打印任务的名称。这个名字将被显示在设备的打印中心，对于有些打印机则显示在液晶屏上。

orientation UIPrintInfoOrientation：.Portrait （默认值）或 .Landscape，如果你打印的内容有一个内置的方向值，如 PDF，这个属性将被忽略。

duplex UIPrintInfoDuplex：.None、.ShortEdge 或 .LongEdge。short- 和 long- 的边界设置指示如何装订双面页面，而 .None 不支持双面打印

outputType UIPrintInfoOutputType：给 UIKit 提供要打印内容的类型提示。可以是以下任意一个：

.General（默认）：文本和图形混合类型；允许双面打印。

.Grayscale：如果你的内容只包括黑色文本，那么该类型比 .General 更好。

.Photo：彩色或黑白图像；禁用双面打印，更适用于图像媒体的纸张类型。

.PhotoGrayscale：对于仅灰度的图像，根据打印机的不同，该类型可能比 .Photo 更好。

printerID String?：一个特定的打印机的 ID，当用户通过 UI 选择过打印机并且保存它作为未来打印预设之后，你才能得到这个类型

UIPrintPaper * printPaper : 打印内容的区域。

UIPrintPaper类的一个实例封装使用的纸张尺寸，打印作业，并在其中的内容可以打印的矩形。

delegate：遵守UIPrintInteractionControllerDelegate 协议的代理。

最重要的就是制定需要打印的内容：

printingItem，printingItems，printFormatter，printPageRenderer。

四个属性都是用来指定要打印的内容的。这四个参数是互斥的，也就是说只要一个赋值，其他三个参数就得是nil. 很容易理解，一个打印任务，不能同时干多个活呀。

printingItem AnyObject! 或 printingItems [AnyObject]!：最基本的等级，控制器只需要已经可打印（图像和 PDF 文件）的内容，并将它们发送到打印机。

printFormatter UIPrintFormatter：更高等级，你可以在应用程序内使用一个 UIPrintFormatter 的子类来对内容进行格式化，然后传给 UIPrintInteractionController。你已经做了一些格式化，剩下的大部分事情打印 API 会处理。

printPageRenderer UIPrintPageRenderer：最高级别，你可以创建 UIPrintPageRenderer 的一个自定义子类，结合页面格式和自己的绘图程序来绘制页眉、页脚和页面内容。

5. 打印流程

5.1 创建 UIPrintInteractionController 实例。

5.2 创建UIPrintInfo 实例。

一个UIPrintInfo对象封装了有关打印作业的信息，包括打印机标识，作业名称，输出类型（照片，正常，灰阶），方向（纵向或横向），和任何选定的双工模式，。打印系统打印时，使用此信息。例如：output type（输出类型）, print orientation（打印方向）, job name（打印工作标识），然后赋值给UIPrintInteractionController 实例的 printInfo属性。

5.3 给delegate 属性赋值，赋的值必须遵守

UIPrintInteractionControllerDelegate 协议。这个代理可以响应 printing options界面的显示和消失，打印工作的开始和结束等。

5.4 指定要打印的内容。也就是指定 printingItem ， printingItems， printFormatter， printPageRenderer. 参数的其中一个。

当你使用 printPageRenderer. 时情况会复杂一些。你可以绘制每一页的header， footer, 内容。这是你需要自己计算页数。另外，你也可以创建一个或多个 UIPrintFormatter实例，通过 addPrintFormatter:startingAtPageAtIndex: 或者 printFormatters参数赋值给 printPageRenderer.实例。这种情况下不需要自己计算多少页。

5.5 最后就是显示显示出printing options 界面了。

在iPad上: presentFromBarButtonItem:animated:completionHandler: 或者 presentFromRect:inView:animated:completionHandler:;

在手机上： presentAnimated:completionHandler:

- (IBAction)print1:(id)sender {

UIPrintInteractionController *printer = [UIPrintInteractionController sharedPrintController];

printer.delegate=self;

//配置打印信息

UIPrintInfo *Pinfo = [UIPrintInfo printInfo];

Pinfo.outputType = UIPrintInfoOutputGeneral;//可打印文本、图形、图像

Pinfo.jobName = @"Print for name";//可选属性，用于在打印中心中标识打印作业

Pinfo.duplex = UIPrintInfoDuplexLongEdge;//双面打印绕长边翻页，NONE为禁止双面

Pinfo.orientation = UIPrintInfoOrientationPortrait;//打印纵向还是横向

Pinfo.outputType = UIPrintInfoOutputGeneral;

// Pinfo.printerID = @"";指定默认打印机，也可以使用UIPrintInteractionControllerDelegate

printer.printInfo= Pinfo;

UIViewPrintFormatter *printFormatter = [self.imageV viewPrintFormatter];

printer.printFormatter= printFormatter;

printer.showsNumberOfCopies = NO;// 拷贝数量显示

printer.showsPaperSelectionForLoadedPapers = YES;

//printer.showsPageRange = NO;// 让用户从打印源中选择一个子范围。这只在多页内容时有用

CGRect rect = self.view.frame;

if ([[UIDevice currentDevice] userInterfaceIdiom] == UIUserInterfaceIdiomPhone) {

// iPhone调用这个方法

[printer presentAnimated:YES completionHandler:^(UIPrintInteractionController* _NonnullprintInteractionController,BOOL completed,NSError* _Nullableerror) {

if(!completed && error) {

NSLog(@"Error");

}

}];

}

if ([[UIDevice currentDevice] userInterfaceIdiom] == UIUserInterfaceIdiomPad) {

// iPad使用这个方法[printer presentFromRect:rect inView:self.view animated:YES completionHandler:^(UIPrintInteractionController* _NonnullprintInteractionController, BOOL completed,NSError* _Nullableerror) {

if(!completed && error) {

NSLog(@"Error");

}

}];

}

}