CommandButton.Builder

Builder(@CommandButton.Icon icon: Int)

Creates a builder.

fun build(): CommandButton!

Builds a CommandButton.

@CanIgnoreReturnValue
fun setCustomIconResId(resId: @DrawableRes Int): CommandButton.Builder!

Sets the fallback resource ID of an icon.

This is used when either the predefined icon is not available, or it's set to ICON_UNDEFINED.

@CanIgnoreReturnValue
fun setDisplayName(displayName: CharSequence!): CommandButton.Builder!

Sets a display name of this button.

@CanIgnoreReturnValue
fun setEnabled(enabled: Boolean): CommandButton.Builder!

Sets whether the button is enabled.

Note that this value will be set to false for MediaController instances if the corresponding command is not available to this controller (see setPlayerCommand and setSessionCommand).

The default value is true.

@CanIgnoreReturnValue
fun setExtras(extras: Bundle!): CommandButton.Builder!

Sets an extra Bundle of this button.

@CanIgnoreReturnValue
fun setIconUri(uri: Uri!): CommandButton.Builder!

Sets a fallback content or resourceUri for the icon of this button.

Note that this Uri may be used when either the predefined icon is not available, or it's set to ICON_UNDEFINED. It can be used in addition to setCustomIconResId for consumers that are capable of loading the content or resource Uri.

@CanIgnoreReturnValue
fun setPlayerCommand(@Player.Command playerCommand: Int): CommandButton.Builder!

Sets the Player.Command that is required to be available when the button is clicked.

Cannot set this if a session command is already set via setSessionCommand.

The controller can execute the action associated with this command. See executeAction for a list of supported actions. If the action requires an additional parameter, use setPlayerCommand instead.

@UnstableApi
@CanIgnoreReturnValue
fun setPlayerCommand(@Player.Command playerCommand: Int, parameter: Any?): CommandButton.Builder!

Sets the Player.Command that is required to be available when the button is clicked.

Cannot set this if a session command is already set via setSessionCommand.

The controller can execute the action associated with this command. See executeAction for a list of supported actions. If the action requires no additional parameter, use setPlayerCommand instead.

@CanIgnoreReturnValue
fun setSessionCommand(sessionCommand: SessionCommand!): CommandButton.Builder!

Sets the SessionCommand that is required to be available when the button is clicked.

Cannot set this if a player command is already set via setPlayerCommand.

The controller can execute the action associated with this command. See executeAction for a list of supported actions. If the action requires an additional parameter, use setSessionCommand instead.

@CanIgnoreReturnValue
@UnstableApi
fun setSessionCommand(sessionCommand: SessionCommand!, parameter: Any?): CommandButton.Builder!

Sets the SessionCommand that is required to be available when the button is clicked.

Cannot set this if a player command is already set via setPlayerCommand.

The controller can execute the action associated with this command. See executeAction for a list of supported actions. If the action requires no additional parameter, use setSessionCommand instead.

@UnstableApi
@CanIgnoreReturnValue
fun setSlots(@CommandButton.Slot slots: IntArray!): CommandButton.Builder!

Sets the allowed Slot positions for this button.

The button is only allowed in the defined slots. If none of the slots can display the button, either because the slots do not exist, are already occupied or the UI surface does not allow the specific type of button in these slots, the button will not be displayed at all.

When multiple slots are provided, they define a preference order. The button will be placed in the first slot in the list that exists, isn't already occupied and that allows this type of button.

When not specified, the default value depends on the associated player command and the Icon set in the constructor:

• COMMAND_PLAY_PAUSE and/or ICON_PLAY, ICON_PAUSE: SLOT_CENTRAL
• COMMAND_SEEK_TO_PREVIOUS, COMMAND_SEEK_TO_PREVIOUS_MEDIA_ITEM, COMMAND_SEEK_BACK and/or ICON_PREVIOUS, ICON_SKIP_BACK, ICON_REWIND: SLOT_BACK
• COMMAND_SEEK_TO_NEXT, COMMAND_SEEK_TO_NEXT_MEDIA_ITEM, COMMAND_SEEK_FORWARD and/or ICON_NEXT, ICON_SKIP_FORWARD, ICON_FAST_FORWARD: SLOT_FORWARD
• Anything else: SLOT_OVERFLOW