summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAmith Yamasani <yamasani@google.com>2015-06-23 12:58:43 -0700
committerAmith Yamasani <yamasani@google.com>2015-06-23 13:02:57 -0700
commitc6ecbce42b8a529447ff327a7902d9da0aeb4310 (patch)
treefd802c4764aaa5b04e3519e3662636aa7de198d2
parentdd7705bbf26dc940ba314807f58dc9a81de452af (diff)
downloadframeworks_base-c6ecbce42b8a529447ff327a7902d9da0aeb4310.zip
frameworks_base-c6ecbce42b8a529447ff327a7902d9da0aeb4310.tar.gz
frameworks_base-c6ecbce42b8a529447ff327a7902d9da0aeb4310.tar.bz2
Clarify the intention of setNotificationsShown
Updated javadoc with a bit more detail. Bug: 21572672 Change-Id: I6b24e47fecd5142bb4bac979cb91f7a6359990d5
-rw-r--r--core/java/android/service/notification/NotificationListenerService.java4
1 files changed, 3 insertions, 1 deletions
diff --git a/core/java/android/service/notification/NotificationListenerService.java b/core/java/android/service/notification/NotificationListenerService.java
index 0309d24..d424546 100644
--- a/core/java/android/service/notification/NotificationListenerService.java
+++ b/core/java/android/service/notification/NotificationListenerService.java
@@ -369,7 +369,9 @@ public abstract class NotificationListenerService extends Service {
/**
* Inform the notification manager that these notifications have been viewed by the
- * user.
+ * user. This should only be called when there is sufficient confidence that the user is
+ * looking at the notifications, such as when the notifications appear on the screen due to
+ * an explicit user interaction.
* @param keys Notifications to mark as seen.
*/
public final void setNotificationsShown(String[] keys) {