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");

            }

        }];

    }

}


ps:plist中设置打印页面显示为中文:

key:Localization native development region 

value:China


参考资料

百度百科:https://baike.baidu.com/item/Airprint

苹果官方文档:https://developer.apple.com/airprint

个人博客:

https://nshipster.cn/uiprintinteractioncontroller/

https://www.jianshu.com/p/7cff5d89f3ac

你可能感兴趣的:(iOS打印 AirPrint 及 普通打印机如何适配)