added in version 24.1.0
belongs to Maven artifact com.android.support:leanback-v17:28.0.0-alpha1

Summary: Nested Classes | Constants | Inherited Constants | Ctors | Methods | Protected Methods | Inherited Methods | [Expand All]

AbstractMediaItemPresenter

This package is part of the Android support library which is no longer maintained. The support library has been superseded by AndroidX which is part of Jetpack. We recommend using the AndroidX libraries in all new projects. You should also consider migrating existing projects to AndroidX. To find the AndroidX class that maps to this deprecated class, see the AndroidX support library class mappings.

public abstract class AbstractMediaItemPresenter
extends RowPresenter

java.lang.Object
↳	android.support.v17.leanback.widget.Presenter
	↳	android.support.v17.leanback.widget.RowPresenter
		↳	android.support.v17.leanback.widget.AbstractMediaItemPresenter

---

Abstract Presenter class for rendering media items in a playlist format. Media item data provided for this presenter can implement the interface MultiActionsProvider, if the media rows wish to contain custom actions. Media items in the playlist are arranged as a vertical list with each row holding each media item's details provided by the user of this class and a set of optional custom actions. Each media item's details and actions are separately focusable. The appearance of each one of the media row components can be controlled through setting theme's attributes. Each media item row provides a view flipper for switching between different views depending on the playback state. A default layout is provided by this presenter for rendering different playback states, or a custom layout can be provided by the user by overriding the playbackMediaItemNumberViewFlipperLayout attribute in the currently specified theme. Subclasses should also override getMediaPlayState(Object) to provide the current play state of their media item model in case they wish to use different views depending on the playback state. The presenter can optionally provide line separators between media rows by setting setHasMediaRowSeparator(boolean) to true.

Subclasses must override onBindMediaDetails(AbstractMediaItemPresenter.ViewHolder, Object) to implement their media item model data binding to each row view.

The OnItemViewClickedListener and OnItemViewSelectedListener can be used in the same fashion to handle selection or click events on either of media details or each individual action views.

AbstractMediaListHeaderPresenter can be used in conjunction with this presenter in order to display a playlist with a header view.

Summary

Nested classes
class	AbstractMediaItemPresenter.ViewHolder The ViewHolder for the AbstractMediaItemPresenter.

Constants
int	PLAY_STATE_INITIAL Indicating that the media item is currently neither playing nor paused.
int	PLAY_STATE_PAUSED Indicating that the media item is currently paused.
int	PLAY_STATE_PLAYING Indicating that the media item is currently playing

Inherited constants

From class android.support.v17.leanback.widget.RowPresenter int SYNC_ACTIVATED_CUSTOM Don't synchronize row view activated status with selected status or expanded status, application will do its own through setActivated(boolean). int SYNC_ACTIVATED_TO_EXPANDED Synchronizes row view's activated status to expand status of the row view holder. int SYNC_ACTIVATED_TO_EXPANDED_AND_SELECTED Sets the row view's activated status to true when both expand and selected are true. int SYNC_ACTIVATED_TO_SELECTED Synchronizes row view's activated status to selected status of the row view holder.

Public constructors
AbstractMediaItemPresenter() Constructor used for creating an abstract media item presenter.
AbstractMediaItemPresenter(int themeId) Constructor used for creating an abstract media item presenter.

Public methods
Presenter	getActionPresenter() Return the presenter used to render a media item row actions.
int	getThemeId() Return The resource id of the theme that defines attributes controlling the appearance of different widgets in a media item row.
boolean	hasMediaRowSeparator()
boolean	isUsingDefaultSelectEffect() Returns true if this RowPresenter is using the default dimming effect.
void	onBindMediaPlayState(AbstractMediaItemPresenter.ViewHolder vh) Binds the media item number view to the appropriate play state view of the media item.
void	onUnbindMediaPlayState(AbstractMediaItemPresenter.ViewHolder vh) Called when the given ViewHolder wants to unbind the play state view.
void	setActionPresenter(Presenter actionPresenter) Sets the action presenter rendering each optional custom action within each media item row.
void	setBackgroundColor(int color) Sets the background color for the row views within the playlist.
void	setHasMediaRowSeparator(boolean hasSeparator) Specifies whether a line separator should be used between media item rows.
void	setThemeId(int themeId) Sets the theme used to style a media item row components.

Protected methods
RowPresenter.ViewHolder	createRowViewHolder(ViewGroup parent) Called to create a ViewHolder object for a Row.
int	getMediaPlayState(Object item) Returns the current play state of the given media item.
boolean	isClippingChildren() Returns true if the Row view should clip its children.
abstract void	onBindMediaDetails(AbstractMediaItemPresenter.ViewHolder vh, Object item) Binds the media item details to their views provided by the AbstractMediaItemPresenter.
void	onBindRowActions(AbstractMediaItemPresenter.ViewHolder vh) Binds the given media item object action to the given ViewHolder's action views.
void	onBindRowViewHolder(RowPresenter.ViewHolder vh, Object item) Binds the given row object to the given ViewHolder.
void	onUnbindMediaDetails(AbstractMediaItemPresenter.ViewHolder vh) Unbinds the media item details from their views provided by the AbstractMediaItemPresenter.

Inherited methods
From class android.support.v17.leanback.widget.RowPresenter abstract RowPresenter.ViewHolder createRowViewHolder(ViewGroup parent) Called to create a ViewHolder object for a Row. void dispatchItemSelectedListener(RowPresenter.ViewHolder vh, boolean selected) This method is only called from onRowViewSelected(ViewHolder, boolean) onRowViewSelected. void freeze(RowPresenter.ViewHolder holder, boolean freeze) Freezes/unfreezes the row, typically used when a transition starts/ends. final RowHeaderPresenter getHeaderPresenter() Returns the Presenter used for rendering the header, or null if none has been set. final RowPresenter.ViewHolder getRowViewHolder(Presenter.ViewHolder holder) Returns the RowPresenter.ViewHolder from the given RowPresenter ViewHolder. final boolean getSelectEffectEnabled() Returns true if the row selection effect is enabled. final float getSelectLevel(Presenter.ViewHolder vh) Returns the current select level. final int getSyncActivatePolicy() Returns the policy of updating row view activated status. void initializeRowViewHolder(RowPresenter.ViewHolder vh) Called after a RowPresenter.ViewHolder is created for a Row. boolean isClippingChildren() Returns true if the Row view should clip its children. boolean isUsingDefaultSelectEffect() Returns true if this RowPresenter is using the default dimming effect. void onBindRowViewHolder(RowPresenter.ViewHolder vh, Object item) Binds the given row object to the given ViewHolder. final void onBindViewHolder(Presenter.ViewHolder viewHolder, Object item) Binds a View to an item. final Presenter.ViewHolder onCreateViewHolder(ViewGroup parent) Creates a new View. void onRowViewAttachedToWindow(RowPresenter.ViewHolder vh) Invoked when the row view is attached to the window. void onRowViewDetachedFromWindow(RowPresenter.ViewHolder vh) Invoked when the row view is detached from the window. void onRowViewExpanded(RowPresenter.ViewHolder vh, boolean expanded) Called when the row view's expanded state changes. void onRowViewSelected(RowPresenter.ViewHolder vh, boolean selected) Called when the given row view changes selection state. void onSelectLevelChanged(RowPresenter.ViewHolder vh) Callback when the select level changes. void onUnbindRowViewHolder(RowPresenter.ViewHolder vh) Unbinds the given ViewHolder. final void onUnbindViewHolder(Presenter.ViewHolder viewHolder) Unbinds a View from an item. final void onViewAttachedToWindow(Presenter.ViewHolder holder) Called when a view created by this presenter has been attached to a window. final void onViewDetachedFromWindow(Presenter.ViewHolder holder) Called when a view created by this presenter has been detached from its window. void setEntranceTransitionState(RowPresenter.ViewHolder holder, boolean afterEntrance) Changes the visibility of views. final void setHeaderPresenter(RowHeaderPresenter headerPresenter) Sets the Presenter used for rendering the header. final void setRowViewExpanded(Presenter.ViewHolder holder, boolean expanded) Sets the expanded state of a Row view. final void setRowViewSelected(Presenter.ViewHolder holder, boolean selected) Sets the selected state of a Row view. final void setSelectEffectEnabled(boolean applyDimOnSelect) Enables or disables the row selection effect. final void setSelectLevel(Presenter.ViewHolder vh, float level) Sets the current select level to a value between 0 (unselected) and 1 (selected). final void setSyncActivatePolicy(int syncActivatePolicy) Sets the policy of updating row view activated status.
From class android.support.v17.leanback.widget.Presenter static void cancelAnimationsRecursive(View view) Utility method for removing all running animations on a view. final Object getFacet(Class<?> facetClass) Queries optional implemented facet. abstract void onBindViewHolder(Presenter.ViewHolder viewHolder, Object item) Binds a View to an item. void onBindViewHolder(Presenter.ViewHolder viewHolder, Object item, List<Object> payloads) Binds a View to an item with a list of payloads. abstract Presenter.ViewHolder onCreateViewHolder(ViewGroup parent) Creates a new View. abstract void onUnbindViewHolder(Presenter.ViewHolder viewHolder) Unbinds a View from an item. void onViewAttachedToWindow(Presenter.ViewHolder holder) Called when a view created by this presenter has been attached to a window. void onViewDetachedFromWindow(Presenter.ViewHolder holder) Called when a view created by this presenter has been detached from its window. final void setFacet(Class<?> facetClass, Object facetImpl) Sets dynamic implemented facet in addition to basic Presenter functions. void setOnClickListener(Presenter.ViewHolder holder, View.OnClickListener listener) Called to set a click listener for the given view holder.
From class java.lang.Object Object clone() boolean equals(Object arg0) void finalize() final Class<?> getClass() int hashCode() final void notify() final void notifyAll() String toString() final void wait(long arg0, int arg1) final void wait(long arg0) final void wait()
From interface android.support.v17.leanback.widget.FacetProvider abstract Object getFacet(Class<?> facetClass) Queries optional implemented facet.

Constants

PLAY_STATE_INITIAL

added in version 25.1.0

int PLAY_STATE_INITIAL

Indicating that the media item is currently neither playing nor paused.

Constant Value: 0 (0x00000000)

PLAY_STATE_PAUSED

added in version 25.1.0

int PLAY_STATE_PAUSED

Indicating that the media item is currently paused.

Constant Value: 1 (0x00000001)

PLAY_STATE_PLAYING

added in version 25.1.0

int PLAY_STATE_PLAYING

Indicating that the media item is currently playing

Constant Value: 2 (0x00000002)

Public constructors

AbstractMediaItemPresenter

added in version 24.1.0

AbstractMediaItemPresenter ()

Constructor used for creating an abstract media item presenter.

AbstractMediaItemPresenter

added in version 24.1.0

AbstractMediaItemPresenter (int themeId)

Constructor used for creating an abstract media item presenter.

Parameters
themeId	int: The resource id of the theme that defines attributes controlling the appearance of different widgets in a media item row.

Public methods

getActionPresenter

added in version 24.1.0

Presenter getActionPresenter ()

Return the presenter used to render a media item row actions.

Returns
Presenter	the presenter used to render a media item row actions.

getThemeId

added in version 24.1.0

int getThemeId ()

Return The resource id of the theme that defines attributes controlling the appearance of different widgets in a media item row.

Returns
int	The resource id of the theme that defines attributes controlling the appearance of different widgets in a media item row.

hasMediaRowSeparator

added in version 24.1.0

boolean hasMediaRowSeparator ()

Returns
boolean

isUsingDefaultSelectEffect

added in version 24.1.0

boolean isUsingDefaultSelectEffect ()

Returns true if this RowPresenter is using the default dimming effect. A subclass may (most likely) return false and override onSelectLevelChanged(ViewHolder).

Returns
boolean

onBindMediaPlayState

added in version 25.1.0

void onBindMediaPlayState (AbstractMediaItemPresenter.ViewHolder vh)

Binds the media item number view to the appropriate play state view of the media item. The play state of the media item is extracted by calling getMediaPlayState(Object) for the media item embedded within this view. This method triggers updating of the playback state UI if corresponding views are specified for the current playback state. By default, 3 views are provided for each playback state, or these views can be provided by the user.

Parameters
vh	AbstractMediaItemPresenter.ViewHolder

onUnbindMediaPlayState

added in version 25.1.0

void onUnbindMediaPlayState (AbstractMediaItemPresenter.ViewHolder vh)

Called when the given ViewHolder wants to unbind the play state view.

Parameters
vh	AbstractMediaItemPresenter.ViewHolder: The ViewHolder to unbind from.

setActionPresenter

added in version 24.1.0

void setActionPresenter (Presenter actionPresenter)

Sets the action presenter rendering each optional custom action within each media item row.

Parameters
actionPresenter	Presenter: the presenter to be used for rendering a media item row actions.

setBackgroundColor

added in version 24.1.0

void setBackgroundColor (int color)

Sets the background color for the row views within the playlist. If this is not set, a default color, defaultBrandColor, from theme is used. This defaultBrandColor defaults to android:attr/colorPrimary on v21, if it's specified.

Parameters
color	int: The ARGB color used to set as the media list background color.

setHasMediaRowSeparator

added in version 24.1.0

void setHasMediaRowSeparator (boolean hasSeparator)

Specifies whether a line separator should be used between media item rows.

Parameters
hasSeparator	boolean: true if a separator should be displayed, false otherwise.

setThemeId

added in version 24.1.0

void setThemeId (int themeId)

Sets the theme used to style a media item row components.

Parameters
themeId	int: The resource id of the theme that defines attributes controlling the appearance of different widgets in a media item row.

Protected methods

createRowViewHolder

added in version 24.1.0

RowPresenter.ViewHolder createRowViewHolder (ViewGroup parent)

Called to create a ViewHolder object for a Row. Subclasses will override this method to return a different concrete ViewHolder object.

Parameters
parent	ViewGroup: The parent View for the Row's view holder.

Returns
RowPresenter.ViewHolder	A ViewHolder for the Row's View.

getMediaPlayState

added in version 25.1.0

int getMediaPlayState (Object item)

Returns the current play state of the given media item. By default, this method returns PLAY_STATE_INITIAL which causes the media item number getMediaItemNameView() to be displayed for different playback states. Users of this class should override this method in order to provide the play state of their custom media item data model.

Parameters
item	Object: The media item

Returns
int	The current play state of this media item

isClippingChildren

added in version 24.1.0

boolean isClippingChildren ()

Returns true if the Row view should clip its children. The clipChildren flag is set on view in initializeRowViewHolder(ViewHolder). Note that Slide transition or explode transition need turn off clipChildren. Default value is false.

Returns
boolean

onBindMediaDetails

added in version 24.1.0

void onBindMediaDetails (AbstractMediaItemPresenter.ViewHolder vh, 
                Object item)

Binds the media item details to their views provided by the AbstractMediaItemPresenter. This method is to be overridden by the users of this presenter. The subclasses of this presenter can access and bind individual views for either of the media item number, name, or duration (depending on whichever views are visible according to the providing theme attributes), by calling getMediaItemNumberView(), getMediaItemNameView(), and getMediaItemDurationView(), on the AbstractMediaItemPresenter.ViewHolder provided as the argument vh of this presenter.

Parameters
vh	AbstractMediaItemPresenter.ViewHolder: The ViewHolder for this AbstractMediaItemPresenter.
item	Object: The media item row object being presented.

onBindRowActions

added in version 24.1.0

void onBindRowActions (AbstractMediaItemPresenter.ViewHolder vh)

Binds the given media item object action to the given ViewHolder's action views.

Parameters
vh	AbstractMediaItemPresenter.ViewHolder: ViewHolder for the media item.

onBindRowViewHolder

added in version 24.1.0

void onBindRowViewHolder (RowPresenter.ViewHolder vh, 
                Object item)

Binds the given row object to the given ViewHolder. Derived classes of RowPresenter overriding onBindRowViewHolder(ViewHolder, Object) must call through the super class's implementation of this method.

Parameters
vh	RowPresenter.ViewHolder
item	Object

onUnbindMediaDetails

added in version 24.1.0

void onUnbindMediaDetails (AbstractMediaItemPresenter.ViewHolder vh)

Unbinds the media item details from their views provided by the AbstractMediaItemPresenter. This method can be overridden by the subclasses of this presenter if required.

Parameters
vh	AbstractMediaItemPresenter.ViewHolder: ViewHolder to unbind from.

• Interfaces

  • BaseGridView.OnKeyInterceptListener
  • BaseGridView.OnMotionInterceptListener
  • BaseGridView.OnTouchInterceptListener
  • BaseGridView.OnUnhandledKeyListener
  • BaseOnItemViewClickedListener
  • BaseOnItemViewSelectedListener
  • BrowseFrameLayout.OnChildFocusListener
  • BrowseFrameLayout.OnFocusSearchListener
  • FacetProvider
  • FacetProviderAdapter
  • FocusHighlight
  • FragmentAnimationProvider
  • ImeKeyMonitor
  • ImeKeyMonitor.ImeKeyListener
  • MultiActionsProvider
  • OnActionClickedListener
  • OnChildLaidOutListener
  • OnChildSelectedListener
  • OnItemViewClickedListener
  • OnItemViewSelectedListener
  • PlaybackSeekUi
  • SearchBar.SearchBarListener
  • SearchBar.SearchBarPermissionListener
  • SearchEditText.OnKeyboardDismissListener
  • SpeechRecognitionCallback
  • TitleViewAdapter.Provider
  • ViewHolderTask

• Classes

  • AbstractDetailsDescriptionPresenter
  • AbstractDetailsDescriptionPresenter.ViewHolder
  • AbstractMediaItemPresenter
  • AbstractMediaItemPresenter.ViewHolder
  • AbstractMediaListHeaderPresenter
  • AbstractMediaListHeaderPresenter.ViewHolder
  • Action
  • ArrayObjectAdapter
  • BaseCardView
  • BaseCardView.LayoutParams
  • BaseGridView
  • BrowseFrameLayout
  • ClassPresenterSelector
  • ControlButtonPresenterSelector
  • CursorObjectAdapter
  • DetailsOverviewLogoPresenter
  • DetailsOverviewLogoPresenter.ViewHolder
  • DetailsOverviewRow
  • DetailsOverviewRow.Listener
  • DetailsOverviewRowPresenter
  • DetailsOverviewRowPresenter.ViewHolder
  • DetailsParallax
  • DiffCallback
  • DividerPresenter
  • DividerRow
  • FocusHighlightHelper
  • FullWidthDetailsOverviewRowPresenter
  • FullWidthDetailsOverviewRowPresenter.Listener
  • FullWidthDetailsOverviewRowPresenter.ViewHolder
  • FullWidthDetailsOverviewRowPresenter.ViewHolder.DetailsOverviewRowListener
  • FullWidthDetailsOverviewSharedElementHelper
  • GuidanceStylist
  • GuidanceStylist.Guidance
  • GuidedAction
  • GuidedAction.Builder
  • GuidedAction.BuilderBase
  • GuidedActionDiffCallback
  • GuidedActionEditText
  • GuidedActionsStylist
  • GuidedActionsStylist.ViewHolder
  • GuidedDatePickerAction
  • GuidedDatePickerAction.Builder
  • GuidedDatePickerAction.BuilderBase
  • HeaderItem
  • HorizontalGridView
  • HorizontalHoverCardSwitcher
  • ImageCardView
  • ItemAlignmentFacet
  • ItemAlignmentFacet.ItemAlignmentDef
  • ItemBridgeAdapter
  • ItemBridgeAdapter.AdapterListener
  • ItemBridgeAdapter.ViewHolder
  • ItemBridgeAdapter.Wrapper
  • ItemBridgeAdapterShadowOverlayWrapper
  • ListRow
  • ListRowHoverCardView
  • ListRowPresenter
  • ListRowPresenter.SelectItemViewHolderTask
  • ListRowPresenter.ViewHolder
  • ListRowView
  • MultiActionsProvider.MultiAction
  • ObjectAdapter
  • ObjectAdapter.DataObserver
  • OnChildViewHolderSelectedListener
  • PageRow
  • Parallax
  • Parallax.FloatProperty
  • Parallax.IntProperty
  • Parallax.PropertyMarkerValue
  • ParallaxEffect
  • ParallaxTarget
  • ParallaxTarget.DirectPropertyTarget
  • ParallaxTarget.PropertyValuesHolderTarget
  • PlaybackControlsRow
  • PlaybackControlsRow.ClosedCaptioningAction
  • PlaybackControlsRow.FastForwardAction
  • PlaybackControlsRow.HighQualityAction
  • PlaybackControlsRow.MoreActions
  • PlaybackControlsRow.MultiAction
  • PlaybackControlsRow.OnPlaybackProgressCallback
  • PlaybackControlsRow.PictureInPictureAction
  • PlaybackControlsRow.PlayPauseAction
  • PlaybackControlsRow.RepeatAction
  • PlaybackControlsRow.RewindAction
  • PlaybackControlsRow.ShuffleAction
  • PlaybackControlsRow.SkipNextAction
  • PlaybackControlsRow.SkipPreviousAction
  • PlaybackControlsRow.ThumbsAction
  • PlaybackControlsRow.ThumbsDownAction
  • PlaybackControlsRow.ThumbsUpAction
  • PlaybackControlsRowPresenter
  • PlaybackControlsRowPresenter.ViewHolder
  • PlaybackRowPresenter
  • PlaybackRowPresenter.ViewHolder
  • PlaybackSeekDataProvider
  • PlaybackSeekDataProvider.ResultCallback
  • PlaybackSeekUi.Client
  • PlaybackTransportRowPresenter
  • PlaybackTransportRowPresenter.ViewHolder
  • Presenter
  • Presenter.ViewHolder
  • Presenter.ViewHolderTask
  • PresenterSelector
  • PresenterSwitcher
  • RecyclerViewParallax
  • RecyclerViewParallax.ChildPositionProperty
  • Row
  • RowHeaderPresenter
  • RowHeaderPresenter.ViewHolder
  • RowHeaderView
  • RowPresenter
  • RowPresenter.ViewHolder
  • SearchBar
  • SearchEditText
  • SearchOrbView
  • SearchOrbView.Colors
  • SectionRow
  • ShadowOverlayContainer
  • ShadowOverlayHelper
  • ShadowOverlayHelper.Builder
  • ShadowOverlayHelper.Options
  • SinglePresenterSelector
  • SparseArrayObjectAdapter
  • SpeechOrbView
  • TitleHelper
  • TitleView
  • TitleViewAdapter
  • VerticalGridPresenter
  • VerticalGridPresenter.ViewHolder
  • VerticalGridView