appsuite_media_api_common_frontend/com.tomtom.ivi.appsuite.media.api.common.frontend.controls/ActionMediaControl

ActionMediaControl

abstract class ActionMediaControl(context: MediaControlContext) : MediaControl

A MediaControl which can be performed on active media.

When launch is invoked on an ActionMediaControl, it is converted to a suitable Action reflecting its current state.

The MediaControlContext gives access to the current state of media playback and hides the link to the media service implementation.

Parameters

context

The context in which this control operates.

Constructors

ActionMediaControl

fun ActionMediaControl(context: MediaControlContext)

Inherited properties

actionType

open val actionType: TtButton.ActionType

The type of the control, which is used by TtButton to apply one of the predefined styles. May be overridden in subclasses in order to apply a specialized style. TtButton.ActionType.TERTIARY is used by default as the most neutral option.

drawable

abstract val drawable: LiveData<DrawableResolver>

The icon of the control, which is used to represent the control to the user.

isAvailable

abstract val isAvailable: LiveData<Boolean>

Whether or not it is possible to launch the action right now.

isVisible

open val isVisible: LiveData<Boolean>

Whether the control is visible. This can be used to show the control as disabled. Defaults to isAvailable.

tag

open val tag: Int?

Int resource ID to tag this MediaControl with. The tag can be used in tests to refer to one or more controls with the same tag.

text

open val text: LiveData<StringResolver>

Textual description of the control.

Functions

launch

open override fun launch(): Boolean

Launch this action using the current action context. The Action, determined by toAction, is performed using the current context. If the action is not currently available, the operation will fail.

toAction

abstract fun toAction(): Action

Convert this ActionMediaControl to an Action to launch it. The IVI media service uses Action objects to issue commands to media sources.