Merge "Controls API - Update template docs" into rvc-dev am: e1ed6dcf57

Original change: https://googleplex-android-review.googlesource.com/c/platform/frameworks/base/+/11898402

Change-Id: I06482c778ee6d74d2fae733aea9567a993a6a299

core/java/android/service/controls/Control.java

@@ -789,6 +789,13 @@ public final class Control implements Parcelable {
         }
 
         /**
+         * Set the {@link ControlTemplate} to define the primary user interaction
+         *
+         * Devices may support a variety of user interactions, and all interactions cannot be
+         * represented with a single {@link ControlTemplate}. Therefore, the selected template
+         * should be most closely aligned with what the expected primary device action will be.
+         * Any secondary interactions can be done via the {@link #setAppIntent(PendingIntent)}.
+         *
          * @param controlTemplate instance of {@link ControlTemplate}, that defines how the
          *                        {@link Control} will behave and what interactions are
          *                        available to the user