Android.PrintServices Namespace

Provides classes for implementing print services.

Remarks

Provides classes for implementing print services. Print services are plug-in components that know how to talk to printers via some standard protocols. These services serve as a bridge between the system and the printers. Hence, the printer and print protocol specific implementation is factored out of the system and can be independently developed and updated.

A print service implementation should extend Android.PrintServices.PrintService and implement its abstract methods. Also the print service has to follow the contract for managing Android.PrintServices.PrintJobs.

The system is responsible for starting and stopping a print service depending on whether there are active print jobs for the printers managed by the service. The print service should also perform printer discovery in a timely fashion to ensure good user experience. The interaction between the system and the print service during printer discovery is encapsulated by a Android.PrintServices.PrinterDiscoverySession instance created by the print service when requested by the system.

Classes

TypeReason
PrintDocumentThis class represents a printed document from the perspective of a print service.
PrinterDiscoverySessionThis class encapsulates the interaction between a print service and the system during printer discovery.
PrintJobThis class represents a print job from the perspective of a print service.
PrintService

Printer discovery

Print jobs

Lifecycle

Declaration

xml Example

 <service android:name=".MyPrintService"
         android:permission="android.permission.BIND_PRINT_SERVICE">
     <intent-filter>
         <action android:name="android.printservice.PrintService" />
     </intent-filter>
     . . .
 </service>
 

Configuration