Allow to select printer from info activity.

Test: Manual testing with modified experimental print service and new
      CTS test for the new API
Fixes: 27746841
Change-Id: I4ef728e54679271a01397d9f04d3b8ac804ffcf3

1 files changed, 23 insertions, 0 deletions

diff --git a/core/java/android/printservice/PrintService.java b/core/java/android/printservice/PrintService.java
index 8f73518eba0f..ecf17707a5c8 100644
--- a/core/java/android/printservice/PrintService.java
+++ b/core/java/android/printservice/PrintService.java
@@ -18,6 +18,8 @@ package android.printservice;
 
 import android.annotation.NonNull;
 import android.annotation.Nullable;
+import android.app.Activity;
+import android.app.PendingIntent;
 import android.app.Service;
 import android.content.ComponentName;
 import android.content.Context;
@@ -29,6 +31,7 @@ import android.os.Message;
 import android.os.RemoteException;
 import android.print.PrintJobInfo;
 import android.print.PrinterId;
+import android.print.PrinterInfo;
 import android.util.Log;
 
 import com.android.internal.util.Preconditions;
@@ -247,6 +250,26 @@ public abstract class PrintService extends Service {
     public static final String EXTRA_PRINT_DOCUMENT_INFO =
             "android.printservice.extra.PRINT_DOCUMENT_INFO";
 
+    /**
+     * When the {@link PendingIntent} declared via
+     * {@link PrinterInfo.Builder#setInfoIntent(PendingIntent)} is called this boolean extra
+     * will be filled in if the activity can select the printer.
+     *
+     * @see #EXTRA_SELECT_PRINTER
+     */
+    public static final String EXTRA_CAN_SELECT_PRINTER =
+            "android.printservice.extra.CAN_SELECT_PRINTER";
+
+    /**
+     * If this boolean extra is set to {@code true} in the {@link Activity#setResult(int, Intent)
+     * result data} from the activity specified in
+     * {@link PrinterInfo.Builder#setInfoIntent(PendingIntent)} the printer will be selected.
+     *
+     * @see #EXTRA_CAN_SELECT_PRINTER
+     */
+    public static final String EXTRA_SELECT_PRINTER =
+            "android.printservice.extra.SELECT_PRINTER";
+
     private Handler mHandler;
 
     private IPrintServiceClient mClient;