Merge "Merge "Adds explanation of MessagingStyle fields" into tm-dev am:...

     * user will always see the normal notification view.

     *

     * <p>

     * If the app is targeting Android P and above, it is required to use the {@link Person}

     * class in order to get an optimal rendering of the notification and its avatars. For

     * conversations involving multiple people, the app should also make sure that it marks the

     * conversation as a group with {@link #setGroupConversation(boolean)}.

     * If the app is targeting Android {@link android.os.Build.VERSION_CODES#P} and above, it is

     * required to use the {@link Person} class in order to get an optimal rendering of the

     * notification and its avatars. For conversations involving multiple people, the app should

     * also make sure that it marks the conversation as a group with

     * {@link #setGroupConversation(boolean)}.

     *

     * <p>

     * This class is a "rebuilder": It attaches to a Builder object and modifies its behavior.

         * @param user Required - The person displayed for any messages that are sent by the

         * user. Any messages added with {@link #addMessage(Notification.MessagingStyle.Message)}

         * who don't have a Person associated with it will be displayed as if they were sent

         * by this user. The user also needs to have a valid name associated with it, which will

         * be enforced starting in Android P.

         * by this user. The user also needs to have a valid name associated with it, which is

         * enforced starting in Android {@link android.os.Build.VERSION_CODES#P}.

         */

        public MessagingStyle(@NonNull Person user) {

            mUser = user;

        /**

         * Sets the title to be displayed on this conversation. May be set to {@code null}.

         *

         * <p>Starting in {@link Build.VERSION_CODES#R, this conversation title will be ignored if a

         * valid shortcutId is added via {@link Notification.Builder#setShortcutId(String)}. In this

         * case, {@link ShortcutInfo#getLongLabel()} (or, if missing,

         * <p>Starting in {@link Build.VERSION_CODES#R}, this conversation title will be ignored

         * if a valid shortcutId is added via {@link Notification.Builder#setShortcutId(String)}.

         * In this case, {@link ShortcutInfo#getLongLabel()} (or, if missing,

         * {@link ShortcutInfo#getShortLabel()}) will be shown as the conversation title

         * instead.

         *

        }

        /**

         * Gets the list of {@code Message} objects that represent the notification

         * Gets the list of {@code Message} objects that represent the notification.

         */

        public List<Message> getMessages() {

            return mMessages;