PrintService
PrintServices 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.
In other word, PrintService is a service that performs the detection of the printer, the processing of the print job. Addition to the role, such as a driver for the network printer, it can also be implemented as a service to be output to any location as a PDF file.
Add and configure PrintService
When you install an application that contains the implementation of PrintService, service will be added to the Printing screen of Settings. The user can launch the settings screen you can switch the On / Off of PrintService each, each PrintService provides.
- PrintManager to display the Print dialog
- (Call of onCreatePrinterDiscoverySession method) that is required to start the session detection of printer from the system
- Return an instance of the class PrinterDiscoverySession
- Add a printer, delete, or update in PrinterDiscoverySession class
- User selects a printer and settings, then printing starts
- PrintJob is passed to the method onPrintJobQueued
- Printing process based on the information of PrintJob
PrintService Implementation
PrintService is an abstract class that inherits from the Service. There are three abstract methods.
One
Two
Three
Four
Five
Six
Seven
Eight
Nine
Ten
Eleven
Twelve
13
14
Fifteen
Sixteen
17
Eighteen
19
| public class SamplePrintService extends PrintService { Override protected PrinterDiscoverySession OenushiaruieitePrinterDiscoverySession () { // I return a search session objects for printer Return null ; } Override protected void OnPrintJobQueued (PrintJob ParamPrintJob) { // I to the printing process } Override protected void OnRequestCancelPrintJob (PrintJob ParamPrintJob) { // Cancel request }} |
onCreatePrinterDiscoverySession ()
When the system starts the detection of printer, onCreatePrinterDiscoverySession method of PrintService is called. There is a need to return an instance of PrinterDiscoverySession is PrintService side at this time. During the detection of the printer, PrinterDiscoverySession is a class that encapsulates the interaction between the system PrintService. Each callback method of PrinterDiscoverySession class will be called, and printer can be added, updated, and deleted.
| Item | Commentary |
|---|---|
| void onStartPrinterDiscovery (List | It starts the detection of the printer. Printer information is already discovered. It adds and updates printers in addPrinters method. It deletes printers in removePrinters method. |
| void onStopPrinterDiscovery () | Callback notifying you that you should stop printer discovery. |
| void onStartPrinterStateTracking (PrinterId printerId) | A callback that asks the user to start tracking of the status of the printer. It is called when the printer is selected in the Print dialog. You must notify the system as soon as possible when the state of the printer has changed |
| void onStopPrinterStateTracking (PrinterId printerId) | A callback to notify that the tracking of the status of the printer is finished. |
| void onValidatePrinters (List | A callback to seek validation list of PrinterId passed as if it were a valid. There is a need to update the printer information in addPrinters method if it is valid |
| void onDestroy () | It will be called when this session is determined to be unnecessary from the system |
In the following section, an implementation example of PrinterDiscoverySession is showed with DropboxPrintService. It does not do anything except that you are adding a printer in onStartPrinterDiscovery method. PrinterInfo.Builder is created for printer information. You can specify printable paper size, color settings, such as resolution. if you pass a list of PrinterInfo in addPrinters method, printer information is displayed in the print dialog box. Create a PrinterInfo in onStartPrinterDiscovery within the method, it calls addPrinters method, but the detection is performed printer to start the thread normally, it will be able to add the printer information using the Handler, etc. .
One
Two
Three
Four
Five
Six
Seven
Eight
Nine
Ten
Eleven
Twelve
13
14
Fifteen
Sixteen
17
Eighteen
19
Twenty
21
22
23
24
25
26
27
28
29
Thirty
31
32
33
34
35
36
37
38
39
Forty
41
42
43
44
45
46
47
48
49
Fifty
51
52
53
54
55
56
57
58
59
Sixty
61
62
63
64
65
66
67
68
69
70
71
72
| public class DiaruopibioxPrinterDiscoverySession extends PrinterDiscoverySession { Private Final Static String TAG = . DiaruopibioxPrinterDiscoverySession class .GetSimpleName (); Private Final Static String PRINTER_ID = "Dropbox.Print.Service" ; Private PrintService MPrintService; public DiaruopibioxPrinterDiscoverySession (PrintService PrintServie) { mPrintService = printServie; } Override public void OnStartPrinterDiscovery (List Log.D (TAG, "OnStartPrinterDiscovery ()" ); for (PrinterID id: printers) { Log.D (TAG, "PrinterID:" + Id.GetLocalId ()); } List NEW ArrayList PrinterId printerId = mPrintService.generatePrinterId (PRINTER_ID); PrinterInfo.Builder Builder = NEW PrinterInfo.Builder (PrinterID, "Dropbox Printer" , PrinterInfo.STATUS_IDLE); PrinterCapabilitiesInfo.Builder capBuilder = NEW PrinterCapabilitiesInfo.Builder (PrinterID); CapBuilder.AddMediaSize (PrintAttributes.MediaSize.ISO_A4, true ); CapBuilder.AddMediaSize (PrintAttributes.MediaSize.ISO_B5, false ); CapBuilder.AddResolution ( NEW PrintAttributes.Resolution ( "Default" , "default Resolution" , 600 , 600 ), true ); capBuilder.setColorModes (PrintAttributes.COLOR_MODE_COLOR | PrintAttributes.COLOR_MODE_MONOCHROME, PrintAttributes.COLOR_MODE_COLOR); builder.setCapabilities (capBuilder.build ()); addPrinters.add (builder.build ()); addPrinters (addPrinters); } Override public void OnStopPrinterDiscovery () { Log.D (TAG, "OnStopPrinterDiscovery ()" ); } Override public void OnValidatePrinters (List Log.D (TAG, "OnValidatePrinters ()" ); for (PrinterID id: PrinterIds) { Log.D (TAG, "PrinterID:" + Id.GetLocalId ()); } } Override public void OenuStartPrinterStateTracking (PrinterID PrinterID) { Log.d (TAG, "OnStartPrinterStateTracking (printerId:" PrinterId.GetLocalId + () + ")" ); } Override public void OnStopPrinterStateTracking (PrinterID PrinterID) { Log.d (TAG, "OnStopPrinterStateTracking (printerId:" PrinterId.GetLocalId + () + ")" ); } Override public void onDestroy () { Log.D (TAG, "onDestroy ()" ); }} |
onPrintJobQueued (PrintJob paramPrintJob)
When a printer is detected, the printing starts, PrintJob is passed to onPrintJobQueued method. Other printer ID, and FileDescriptor color information and print size, to a PDF file is included in the PrintJob. This is done using the FileDescriptor is taken out of print data. PrintJob will have a status start, finished, failed, and canceled. Should be set in accordance with the state of printing. The following is an example to save and retrieve the PDF from PrintJob. You have done all the work on onPrintJobQueued method, but will be using the AsyncTask, etc. usually. However, operation of PrintJob must be done on the UI thread. FileDescriptor of PDF data is similar. If you want to send to the network on the PDF data, you will need to use the AsyncTask on which the file was created, etc. time.
One
Two
Three
Four
Five
Six
Seven
Eight
Nine
Ten
Eleven
Twelve
13
14
Fifteen
Sixteen
17
Eighteen
19
Twenty
21
22
23
24
25
26
27
28
29
Thirty
31
32
33
34
| Overrideprotected void OnPrintJobQueued ( Final PrintJob PRINTJOB) { printJob.start (); File tmp = NEW File (GetExternalCacheDir (), PrintJob.GetDocument () . .getInfo () getName ()); FileOutputStream fos = null ; FileInputStream FIN = null ; TRY { fos = NEW FileOutputStream (tmp); FIN = NEW FileInputStream (PrintJob.GetDocument () . .getData () getFileDescriptor ()); int c; byte [] bytes = NEW byte [ 1024 ]; while ((c = Fin.Read (bytes)) = -! 1 ) { Fos.Write (bytes, 0 , c); } fos.close (); fin.close (); } catch (Exception e) { e.printStackTrace (); printJob.fail (e.getMessage ()); Return ; } finally { if (fos =! null ) { TRY {Fos.Close ();} catch (Exception e) {}} if (FIN =! null ) { TRY {Fin.Close ();} catch (Exception e) {}} } printJob.complete ();} |
PrintJob so are queued automatically PrintService, you do not need to be the handling of the queue on your own again.PrintJob active can be retrieved in getActivePrintJobs method.
onRequestCancelPrintJob (PrintJob paramPrintJob)
onRequestCancelPrintJob method is called when the user cancels the print job. PrintJob are passed, you need to stop the process corresponding. You can also check in isCancelled method of PrintJob class
One
Two
Three
Four
Five
Six
Seven
Eight
Nine
Ten
| protected void OnPostExecute (PrintStatus result) { if (PrintJob.IsCancelled ()) { I toast ( "has been canceled" ); } else if (Result.IsError ()) { printJob.fail (result.getMessage ()); } else { printJob.complete (); } toast (result.getMessage ());}; |
AndroidManifest.xml
One
Two
Three
Four
Five
Six
Seven
| Android: name = "App.Package.Name..YourPrintService" Android: permission = "Android.Permission.BIND_PRINT_SERVICE" > </ Intent-filter></ Service> |
Setting Screen
In many cases, you will need to PrintService settings to connect to the printer over a network. Alternatively, you can configure the metadata when you define a PrintService in AndroidManifest.xml.
One
Two
Three
Four
| Android: description = "@ string / description" Android: SettingsActivity = "App.Package.Name.YourSettingActivity" /> |
You can specify the metadata of AndroidManifest.xml the XML file that you create and define Activity of the setting screen.
One
Two
Three
Four
Five
Six
Seven
Eight
Nine
Ten
Eleven
Twelve
13
14
Fifteen
Sixteen
17
Eighteen
19
| Android: name = "App.Package.Name.YourPrintService" Android: permission = "Android.Permission.BIND_PRINT_SERVICE" > </ Intent-filter> Android: name = "Android.Printservice" Android: resource = "@ xml / Your_printservice" > </ Meta-data></ Service> Android: name = "App.Package.Name.YourSettingActivity" Android: exported = "true" Android: Label = "@ string / Title_activity_setting" Android: permission = "Android.Permission.BIND_PRINT_SERVICE" ></ Activity> |
DropboxPrintService
- Source is here → DropboxPrintService
- It does not include an API key towards the source, be sure to get the API key in Dropbox If you want to use it to build from source.
- apk here → DropboxPrintService.Apk
Log in to the Dropbox
When you have made all of your installed the DropboxPrintService, first log in to the Dropbox. Select the DropboxPrintService in Printing screen of Settings, turn ON the DropboxPrintService open the detail screen. Please log in to Dropbox so open the setting screen from the bottom menu.
PDF is uploaded to Dropbox
