Merge "Add information about requestAddControl" into rvc-dev

2020-06-23 22:33:09 +00:00
parent e16a6a02a7 e134edc497
commit c139a0071a
1 changed files with 4 additions and 0 deletions
--- a/core/java/android/service/controls/ControlsProviderService.java
+++ b/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}