diff --git a/core/java/android/app/NotificationManager.java b/core/java/android/app/NotificationManager.java index 4aa2d2e8a6a0d..392f52a08fb5c 100644 --- a/core/java/android/app/NotificationManager.java +++ b/core/java/android/app/NotificationManager.java @@ -2573,11 +2573,18 @@ public class NotificationManager { * method will return false regardless of input. *
*
- * The provided URI must meet the requirements for a URI associated with a
- * {@link Person}: it may be the {@code String} representation of a
- * {@link android.provider.ContactsContract.Contacts#CONTENT_LOOKUP_URI}, or a
- * mailto: or tel: schema URI matching an entry in the
- * Contacts database. See also {@link Person.Builder#setUri} and
+ * The provided URI should be a tel: or mailto: schema URI indicating
+ * the source of the call. For an accurate answer regarding whether the caller matches the
+ * user's permitted contacts, the path part of the URI must match an entry the Contacts database
+ * in the appropriate column.
+ *
+ * Passing in a {@link android.provider.ContactsContract.Contacts#CONTENT_LOOKUP_URI} is also + * permissible, but should only be used for priority contact interruptions and may not provide + * accurate results in the case of repeat callers. + *
+ *+ * See also {@link Person.Builder#setUri} and * {@link android.provider.ContactsContract.Contacts#CONTENT_LOOKUP_URI} * for more information. *