Merge "Add information about requestAddControl" into rvc-dev am: c139a0071a am: 7bbfde8105 am: ab3b16142c

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

Change-Id: Ie39e3f09ab606069b726875b09a1175a8b4eda3c

core/java/android/service/controls/ControlsProviderService.java

@@ -296,6 +296,10 @@ public abstract class ControlsProviderService extends Service {
 
     /**
      * Request SystemUI to prompt the user to add a control to favorites.
+     * <br>
+     * SystemUI may not honor this request in some cases, for example if the requested
+     * {@link Control} is already a favorite, or the requesting package is not currently in the
+     * foreground.
      *
      * @param context A context
      * @param componentName Component name of the {@link ControlsProviderService}