summaryrefslogtreecommitdiff
path: root/core/java/android
diff options
context:
space:
mode:
authorFabian Kozynski <kozynski@google.com>2020-06-23 15:46:35 -0400
committerFabian Kozynski <kozynski@google.com>2020-06-23 15:48:10 -0400
commite134edc4977f3f12621b5c303eb85618334e9727 (patch)
tree02d51e8bbc03f75a4d0a97d966a31b84e0b5bd01 /core/java/android
parentda525e98d52b4fb89f195e32acb19d6110203ef1 (diff)
Add information about requestAddControl
Add possible conditions under which SystemUI may not prompt the user to add a control. Test: no test Fixes: 159728016 Change-Id: I143e50cc15397d85b4212d9fb29d64df7c2de80c
Diffstat (limited to 'core/java/android')
-rw-r--r--core/java/android/service/controls/ControlsProviderService.java4
1 files changed, 4 insertions, 0 deletions
diff --git a/core/java/android/service/controls/ControlsProviderService.java b/core/java/android/service/controls/ControlsProviderService.java
index 4e5aa0018b61..6bd376a19fc5 100644
--- 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}