platform_frontend_api_common_frontend/com.tomtom.ivi.platform.frontend.api.common.frontend.panels/MainProcessPanel

MainProcessPanel

abstract class MainProcessPanel(frontendContext: FrontendContext, priority: MainProcessPanel.Priority) : GenericPanel<CommonPanelContext>

A panel which visualizes processes in the UI. For example, an ongoing audio streaming process.

A MainProcessPanel changes its priority when there are changes in how much attention the process requires.

The system UI is expected to directly react on priority changes. Sometimes it is necessary to keep showing a MainProcessPanel for some time after the process becomes less relevant, for example to keep showing the contact who has just tried calling the user. In such cases, the frontend is expected to delay lowering its own priority.

Setting the priority to the same level it was set previously also signals the system UI that the process was somehow updated, and allows it to evaluate the relevance of the MainProcessPanel once again.

To understand how the system UI uses the priority level, see UniquePriority.

Parameters

frontendContext

An entry point for this Panel to communicate with the rest of the system.

priority

The initial Priority level of the panel.

Constructors

MainProcessPanel

constructor(frontendContext: FrontendContext, priority: MainProcessPanel.Priority)

Types

Priority

enum Priority : Enum<MainProcessPanel.Priority>

The priority level of the process.

UniquePriority

class UniquePriority(val priority: MainProcessPanel.Priority) : Comparable<MainProcessPanel.UniquePriority>

A UniquePriority assigned to a MainProcessPanel offers the ability to sort panels not just by priority, but also by which priority level was most recently set.

Properties

priority

val priority: LiveData<MainProcessPanel.UniquePriority>

The current Priority of the panel.

Inherited properties

frontendContext

val frontendContext: FrontendContext

val id: Long

Unique identifier of a GenericPanel. Each ID is an increment of the previously created panel's ID, allowing this value to be used for sorting purposes.

isAttached

var isAttached: Boolean

true if the panel is currently attached.

lifecycle

open override val lifecycle: Lifecycle

requestsRemoval

open val requestsRemoval: LiveData<Boolean>

Whether a panel wants to be removed from its frontend.

tag

val tag: String

The tag to recognise this panel with. Useful in combination with fragment tags to detect which fragment belongs to which panel.

transitionDestination

var transitionDestination: PanelTransitionDestination?

A destination that the information contained by this panel transitions to when this panel closes. By default it is null, indicating the information does not transition anywhere.

transitionSource

var transitionSource: PanelTransitionSource?

The source of the information contained by this panel when the information transitions from another panel to this one. By default it is null, indicating the information does not transition from any other particular panel.