ConversationItem.Builder

public final class ConversationItem.Builder


A builder for ConversationItem

Summary

Public constructors

Returns an empty Builder instance.

Returns a builder from the given ConversationItem.

Public methods

@NonNull ConversationItem.Builder

Adds an additional action for the conversation.

@NonNull ConversationItem

Returns a new ConversationItem instance defined by this builder

@NonNull ConversationItem.Builder
setConversationCallback(
    @NonNull ConversationCallback conversationCallback
)

Sets a ConversationCallback for the conversation

@NonNull ConversationItem.Builder
setGroupConversation(boolean isGroupConversation)

Specifies whether this conversation involves 3+ participants (a "group" conversation)

@NonNull ConversationItem.Builder

Sets a CarIcon for the conversation

@NonNull ConversationItem.Builder

Specifies a unique identifier for the conversation

@NonNull ConversationItem.Builder

Specifies a list of messages for the conversation

@NonNull ConversationItem.Builder

Sets a Person for the conversation

@NonNull ConversationItem.Builder

Sets the title of the conversation

Public constructors

Builder

Added in 1.3.0
public Builder()

Returns an empty Builder instance.

Builder

Added in 1.4.0-rc02
public Builder(@NonNull ConversationItem other)

Returns a builder from the given ConversationItem.

Public methods

addAction

Added in 1.4.0-rc02
public @NonNull ConversationItem.Builder addAction(@NonNull Action action)

Adds an additional action for the conversation.

Throws
java.lang.NullPointerException

if action is null

java.lang.IllegalArgumentException

if action contains unsupported Action types, exceeds the maximum number of allowed actions (1) or does not contain a valid CarIcon.

build

Added in 1.3.0
public @NonNull ConversationItem build()

Returns a new ConversationItem instance defined by this builder

setConversationCallback

Added in 1.4.0-rc02
public @NonNull ConversationItem.Builder setConversationCallback(
    @NonNull ConversationCallback conversationCallback
)

Sets a ConversationCallback for the conversation

setGroupConversation

Added in 1.3.0
public @NonNull ConversationItem.Builder setGroupConversation(boolean isGroupConversation)

Specifies whether this conversation involves 3+ participants (a "group" conversation)

If unspecified, conversations are assumed to have exactly two participants (a "1:1" conversation)

UX presentation may differ slightly between group and 1:1 conversations. As a historical example, message readout may include sender names for group conversations, but omit them for 1:1 conversations.

setIcon

Added in 1.3.0
public @NonNull ConversationItem.Builder setIcon(@NonNull CarIcon icon)

Sets a CarIcon for the conversation

setId

Added in 1.3.0
public @NonNull ConversationItem.Builder setId(@NonNull String id)

Specifies a unique identifier for the conversation

IDs may be used for a variety of purposes, including...

setMessages

Added in 1.3.0
public @NonNull ConversationItem.Builder setMessages(@NonNull List<CarMessage> messages)

Specifies a list of messages for the conversation

The messages should be sorted from oldest to newest.

setSelf

Added in 1.4.0-rc02
public @NonNull ConversationItem.Builder setSelf(@NonNull Person self)

Sets a Person for the conversation

The Person must specify a non-null setName and setKey.

setTitle

Added in 1.3.0
public @NonNull ConversationItem.Builder setTitle(@NonNull CarText title)

Sets the title of the conversation