TelephoneKeypadTemplate.Builder

public Builder(@NonNull TelephoneKeypadTemplate template)

Create a Builder for a TelephoneKeypadTemplate with values from the given template.

public Builder(
    @NonNull Action primaryAction,
    @NonNull TelephoneKeypadTemplate.PhoneNumberChangeListener numberChangeListener
)

Creates a builder for a TelephoneKeypadTemplate.

primaryAction is usually the "call" button, but can be set arbitrarily by the app (eg. it can be a hangup button when the user is in a call). This action must include an icon,must not have text, and may define a custom color (subject to contrast requirements). This action is subject to the constraints defined in ACTION_CONSTRAINTS_TELEPHONE_KEYPAD_PRIMARY.

The app must keep track of the dialed phone number via numberChangeListener because the primary action's setOnClickListener does not provide the fully dialed phone number.

@CanIgnoreReturnValue
public @NonNull TelephoneKeypadTemplate.Builder addKeySecondaryText(int key, @NonNull CarText secondaryText)

Sets the secondary text underneath the numbers/symbols of the keypad, overwriting any text that already exists for the given key. Both icon and text is allowed (for example, showing a voicemail icon underneath the 1 key to denote that pressing and holding that key will automatically call voicemail). The secondaryText is subject to the constraints defined in TEXT_AND_ICON.

Throws an IllegalArgumentException for any invalid keys.

public @NonNull TelephoneKeypadTemplate build()

Builds a TelephoneKeypadTemplate

@CanIgnoreReturnValue
public @NonNull TelephoneKeypadTemplate.Builder setHeader(@Nullable Header header)

Sets the header to show in the template.

The start action of the header, if present, is subject to the constraints defined in ACTION_CONSTRAINTS_TELEPHONE_KEYPAD_HEADER.

@CanIgnoreReturnValue
public @NonNull TelephoneKeypadTemplate.Builder setKeySecondaryTexts(@NonNull Map<Integer, CarText> secondaryTexts)

Sets all the given button's secondaryTexts, overwriting existing values, but not clearing any existing values (eg. if KEY_ONE was already added and the map passed in only included TWO, the result would be both ONE and TWO). Throws an IllegalArgumentException for any invalid keys.

@CanIgnoreReturnValue
public @NonNull TelephoneKeypadTemplate.Builder setPhoneNumber(@Nullable String phoneNumber)

Sets the phone number to show in the dialer which can be edited before calling.

If a phone number is being edited in an existing instance of this template the value will be reset to the phone number in the new template.

@CanIgnoreReturnValue
public @NonNull TelephoneKeypadTemplate.Builder setTelephoneKeypadCallback(@Nullable TelephoneKeypadCallback callback)

Sets the callback for the keypad. See TelephoneKeypadCallback.