From 005e774ac8f733a496ca2fc973e2e48668df2c81 Mon Sep 17 00:00:00 2001 From: Adrian Roos Date: Wed, 13 Apr 2016 15:02:20 -0700 Subject: [PATCH] API Review: Improve javadoc of EXTRA_REMOTE_INPUT Change-Id: I3b23a44ca54be7724ddb29c432bb6975a784b5b4 Fixes: 27365667 --- core/java/android/app/Notification.java | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/core/java/android/app/Notification.java b/core/java/android/app/Notification.java index a759719dcd3c6..93acefa07310c 100644 --- a/core/java/android/app/Notification.java +++ b/core/java/android/app/Notification.java @@ -777,6 +777,16 @@ public class Notification implements Parcelable /** * {@link #extras} key: this is the remote input history, as supplied to * {@link Builder#setRemoteInputHistory(CharSequence[])}. + * + * Apps can fill this through {@link Builder#setRemoteInputHistory(CharSequence[])} + * with the most recent inputs that have been sent through a {@link RemoteInput} of this + * Notification and are expected to clear it once the it is no longer relevant (e.g. for chat + * notifications once the other party has responded). + * + * The extra with this key is of type CharSequence[] and contains the most recent entry at + * the 0 index, the second most recent at the 1 index, etc. + * + * @see Builder#setRemoteInputHistory(CharSequence[]) */ public static final String EXTRA_REMOTE_INPUT_HISTORY = "android.remoteInputHistory";