# AbstractMediaItemPresenter

Artifact: [androidx.leanback:leanback](https://developer.android.com/jetpack/androidx/releases/leanback) [View Source](https://cs.android.com/search?q=file:androidx/leanback/widget/AbstractMediaItemPresenter.java+class:androidx.leanback.widget.AbstractMediaItemPresenter) Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

*** ** * ** ***

<br />

```
public abstract class AbstractMediaItemPresenter extends RowPresenter
```

<br />

|---|---|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object.html) ||||
| ↳ | [androidx.leanback.widget.Presenter](https://developer.android.com/reference/androidx/leanback/widget/Presenter) |||
|   | ↳ | [androidx.leanback.widget.RowPresenter](https://developer.android.com/reference/androidx/leanback/widget/RowPresenter) ||
|   |   | ↳ | [androidx.leanback.widget.AbstractMediaItemPresenter](https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter) |

*** ** * ** ***

Abstract `https://developer.android.com/reference/androidx/leanback/widget/Presenter` class for rendering media items in a playlist format. Media item data provided for this presenter can implement the interface `https://developer.android.com/reference/androidx/leanback/widget/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 `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter#getMediaPlayState(java.lang.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 `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter#setHasMediaRowSeparator(boolean)` to true.

Subclasses must override `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter#onBindMediaDetails(androidx.leanback.widget.AbstractMediaItemPresenter.ViewHolder,java.lang.Object)` to implement their media item model data binding to each row view.

The `https://developer.android.com/reference/androidx/leanback/widget/OnItemViewClickedListener` and `https://developer.android.com/reference/androidx/leanback/widget/OnItemViewSelectedListener` can be used in the same fashion to handle selection or click events on either of media details or each individual action views.

`https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaListHeaderPresenter` can be used in conjunction with this presenter in order to display a playlist with a header view.

## Summary

| ### Nested types |
|---|
| `public class https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter.ViewHolder extends https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder` The ViewHolder for the `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter`. |

| ### Constants |
|---|---|
| `static final int` | `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter#PLAY_STATE_INITIAL() = 0` Indicating that the media item is currently neither playing nor paused. |
| `static final int` | `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter#PLAY_STATE_PAUSED() = 1` Indicating that the media item is currently paused. |
| `static final int` | `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter#PLAY_STATE_PLAYING() = 2` Indicating that the media item is currently playing |

| ### Public constructors |
|---|
| `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter#AbstractMediaItemPresenter()()` Constructor used for creating an abstract media item presenter. |
| `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter#AbstractMediaItemPresenter(int)(int themeId)` Constructor used for creating an abstract media item presenter. |

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

| ### Protected methods |
|---|---|
| `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder` | `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter#createRowViewHolder(android.view.ViewGroup)(https://developer.android.com/reference/android/view/ViewGroup.html parent)` Called to create a ViewHolder object for a Row. |
| `int` | `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter#getMediaPlayState(java.lang.Object)(https://developer.android.com/reference/java/lang/Object.html item)` Returns the current play state of the given media item. |
| `boolean` | `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter#isClippingChildren()()` Returns true if the Row view should clip its children. |
| `abstract void` | `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter#onBindMediaDetails(androidx.leanback.widget.AbstractMediaItemPresenter.ViewHolder,java.lang.Object)( https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter.ViewHolder vh, https://developer.android.com/reference/java/lang/Object.html item )` Binds the media item details to their views provided by the `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter`. |
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter#onBindRowActions(androidx.leanback.widget.AbstractMediaItemPresenter.ViewHolder)(https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter.ViewHolder vh)` Binds the given media item object action to the given ViewHolder's action views. |
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter#onBindRowViewHolder(androidx.leanback.widget.RowPresenter.ViewHolder,java.lang.Object)( @https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder vh, @https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/java/lang/Object.html item )` Binds the given row object to the given ViewHolder. |
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter#onUnbindMediaDetails(androidx.leanback.widget.AbstractMediaItemPresenter.ViewHolder)(https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter.ViewHolder vh)` Unbinds the media item details from their views provided by the `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter`. |

### Inherited Constants

From [androidx.leanback.widget.RowPresenter](https://developer.android.com/reference/androidx/leanback/widget/RowPresenter) `static final int` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#SYNC_ACTIVATED_CUSTOM() = 0`

Don't synchronize row view activated status with selected status or expanded status, application will do its own through `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder#setActivated(boolean)`.
`static final int` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#SYNC_ACTIVATED_TO_EXPANDED() = 1`

Synchronizes row view's activated status to expand status of the row view holder.
`static final int` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#SYNC_ACTIVATED_TO_EXPANDED_AND_SELECTED() = 3`

Sets the row view's activated status to true when both expand and selected are true.
`static final int` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#SYNC_ACTIVATED_TO_SELECTED() = 2`

Synchronizes row view's activated status to selected status of the row view holder.

### Inherited methods

From [androidx.leanback.widget.FacetProvider](https://developer.android.com/reference/androidx/leanback/widget/FacetProvider) `abstract @https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/java/lang/Object.html` `https://developer.android.com/reference/androidx/leanback/widget/FacetProvider#getFacet(java.lang.Class<?>)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/java/lang/Class.html<@https://developer.android.com/reference/androidx/annotation/NonNull ?> facetClass)`

Queries optional implemented facet.
From [androidx.leanback.widget.Presenter](https://developer.android.com/reference/androidx/leanback/widget/Presenter) `static void` `https://developer.android.com/reference/androidx/leanback/widget/Presenter#cancelAnimationsRecursive(android.view.View)(https://developer.android.com/reference/android/view/View.html view)`

Utility method for removing all running animations on a view.
`final https://developer.android.com/reference/java/lang/Object.html` `https://developer.android.com/reference/androidx/leanback/widget/Presenter#getFacet(java.lang.Class<?>)(https://developer.android.com/reference/java/lang/Class.html<@https://developer.android.com/reference/androidx/annotation/NonNull ?> facetClass)`

Queries optional implemented facet.
`abstract void` `https://developer.android.com/reference/androidx/leanback/widget/Presenter#onBindViewHolder(androidx.leanback.widget.Presenter.ViewHolder,java.lang.Object)(

@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder viewHolder,

@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/java/lang/Object.html item

)`

Binds a `https://developer.android.com/reference/android/view/View.html` to an item.
`void` `https://developer.android.com/reference/androidx/leanback/widget/Presenter#onBindViewHolder(androidx.leanback.widget.Presenter.ViewHolder,java.lang.Object,java.util.List<java.lang.Object>)(

@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder viewHolder,

@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/java/lang/Object.html item,

@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/java/lang/Object.html> payloads

)`

Binds a `https://developer.android.com/reference/android/view/View.html` to an item with a list of payloads.
`abstract @https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder` `https://developer.android.com/reference/androidx/leanback/widget/Presenter#onCreateViewHolder(android.view.ViewGroup)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/view/ViewGroup.html parent)`

Creates a new `https://developer.android.com/reference/android/view/View.html`.
`abstract void` `https://developer.android.com/reference/androidx/leanback/widget/Presenter#onUnbindViewHolder(androidx.leanback.widget.Presenter.ViewHolder)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder viewHolder)`

Unbinds a `https://developer.android.com/reference/android/view/View.html` from an item.
`void` `https://developer.android.com/reference/androidx/leanback/widget/Presenter#onViewAttachedToWindow(androidx.leanback.widget.Presenter.ViewHolder)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder holder)`

Called when a view created by this presenter has been attached to a window.
`void` `https://developer.android.com/reference/androidx/leanback/widget/Presenter#onViewDetachedFromWindow(androidx.leanback.widget.Presenter.ViewHolder)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder holder)`

Called when a view created by this presenter has been detached from its window.
`final void` `https://developer.android.com/reference/androidx/leanback/widget/Presenter#setFacet(java.lang.Class<?>,java.lang.Object)(https://developer.android.com/reference/java/lang/Class.html<@https://developer.android.com/reference/androidx/annotation/NonNull ?> facetClass, https://developer.android.com/reference/java/lang/Object.html facetImpl)`

Sets dynamic implemented facet in addition to basic Presenter functions.
`void` `https://developer.android.com/reference/androidx/leanback/widget/Presenter#setOnClickListener(androidx.leanback.widget.Presenter.ViewHolder,android.view.View.OnClickListener)(

https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder holder,

https://developer.android.com/reference/android/view/View.OnClickListener.html listener

)`

Called to set a click listener for the given view holder.
From [androidx.leanback.widget.RowPresenter](https://developer.android.com/reference/androidx/leanback/widget/RowPresenter) `void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#dispatchItemSelectedListener(androidx.leanback.widget.RowPresenter.ViewHolder,boolean)(

https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder vh,

boolean selected

)`

This method is only called from `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onRowViewSelected(androidx.leanback.widget.RowPresenter.ViewHolder,boolean)` onRowViewSelected.
`void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#freeze(androidx.leanback.widget.RowPresenter.ViewHolder,boolean)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder holder, boolean freeze)`

Freezes/unfreezes the row, typically used when a transition starts/ends.
`final https://developer.android.com/reference/androidx/leanback/widget/RowHeaderPresenter` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#getHeaderPresenter()()`

Returns the Presenter used for rendering the header, or null if none has been set.
`final https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#getRowViewHolder(androidx.leanback.widget.Presenter.ViewHolder)(https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder holder)`

Returns the `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder` from the given RowPresenter ViewHolder.
`final boolean` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#getSelectEffectEnabled()()`

Returns true if the row selection effect is enabled.
`final float` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#getSelectLevel(androidx.leanback.widget.Presenter.ViewHolder)(https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder vh)`

Returns the current select level.
`final int` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#getSyncActivatePolicy()()`

Returns the policy of updating row view activated status.
`void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#initializeRowViewHolder(androidx.leanback.widget.RowPresenter.ViewHolder)(https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder vh)`

Called after a `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder` is created for a Row.
`final void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onBindViewHolder(androidx.leanback.widget.Presenter.ViewHolder,java.lang.Object)(

@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder viewHolder,

@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/java/lang/Object.html item

)`

Binds a `https://developer.android.com/reference/android/view/View.html` to an item.
`final https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onCreateViewHolder(android.view.ViewGroup)(https://developer.android.com/reference/android/view/ViewGroup.html parent)`

Creates a new `https://developer.android.com/reference/android/view/View.html`.
`void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onRowViewAttachedToWindow(androidx.leanback.widget.RowPresenter.ViewHolder)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder vh)`

Invoked when the row view is attached to the window.
`void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onRowViewDetachedFromWindow(androidx.leanback.widget.RowPresenter.ViewHolder)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder vh)`

Invoked when the row view is detached from the window.
`void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onRowViewExpanded(androidx.leanback.widget.RowPresenter.ViewHolder,boolean)(https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder vh, boolean expanded)`

Called when the row view's expanded state changes.
`void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onRowViewSelected(androidx.leanback.widget.RowPresenter.ViewHolder,boolean)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder vh, boolean selected)`

Called when the given row view changes selection state.
`void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onSelectLevelChanged(androidx.leanback.widget.RowPresenter.ViewHolder)(https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder vh)`

Callback when the select level changes.
`void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onUnbindRowViewHolder(androidx.leanback.widget.RowPresenter.ViewHolder)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder vh)`

Unbinds the given ViewHolder.
`final void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onUnbindViewHolder(androidx.leanback.widget.Presenter.ViewHolder)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder viewHolder)`

Unbinds a `https://developer.android.com/reference/android/view/View.html` from an item.
`final void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onViewAttachedToWindow(androidx.leanback.widget.Presenter.ViewHolder)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder holder)`

Called when a view created by this presenter has been attached to a window.
`final void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onViewDetachedFromWindow(androidx.leanback.widget.Presenter.ViewHolder)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder holder)`

Called when a view created by this presenter has been detached from its window.
`void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#setEntranceTransitionState(androidx.leanback.widget.RowPresenter.ViewHolder,boolean)(

@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder holder,

boolean afterEntrance

)`

Changes the visibility of views.
`final void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#setHeaderPresenter(androidx.leanback.widget.RowHeaderPresenter)(https://developer.android.com/reference/androidx/leanback/widget/RowHeaderPresenter headerPresenter)`

Sets the Presenter used for rendering the header.
`final void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#setRowViewExpanded(androidx.leanback.widget.Presenter.ViewHolder,boolean)(https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder holder, boolean expanded)`

Sets the expanded state of a Row view.
`final void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#setRowViewSelected(androidx.leanback.widget.Presenter.ViewHolder,boolean)(https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder holder, boolean selected)`

Sets the selected state of a Row view.
`final void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#setSelectEffectEnabled(boolean)(boolean applyDimOnSelect)`

Enables or disables the row selection effect.
`final void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#setSelectLevel(androidx.leanback.widget.Presenter.ViewHolder,float)(https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder vh, float level)`

Sets the current select level to a value between 0 (unselected) and 1 (selected).
`final void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#setSyncActivatePolicy(int)(int syncActivatePolicy)`

Sets the policy of updating row view activated status.

## Constants

### PLAY_STATE_INITIAL

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public static final int PLAY_STATE_INITIAL = 0
```

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

### PLAY_STATE_PAUSED

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public static final int PLAY_STATE_PAUSED = 1
```

Indicating that the media item is currently paused.

### PLAY_STATE_PLAYING

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public static final int PLAY_STATE_PLAYING = 2
```

Indicating that the media item is currently playing

## Public constructors

### AbstractMediaItemPresenter

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public AbstractMediaItemPresenter()
```

Constructor used for creating an abstract media item presenter.

### AbstractMediaItemPresenter

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public AbstractMediaItemPresenter(int themeId)
```

Constructor used for creating an abstract media item presenter.

| Parameters |
|---|---|
| `int themeId` | 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 [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public Presenter getActionPresenter()
```

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

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/leanback/widget/Presenter` | the presenter used to render a media item row actions. |

### getThemeId

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public 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 [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public boolean hasMediaRowSeparator()
```

### isUsingDefaultSelectEffect

```
public boolean isUsingDefaultSelectEffect()
```

Returns true if this RowPresenter is using the default dimming effect. A subclass may (most likely) return false and override `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onSelectLevelChanged(androidx.leanback.widget.RowPresenter.ViewHolder)`.

### onBindMediaPlayState

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public 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 `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter#getMediaPlayState(java.lang.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.

### onUnbindMediaPlayState

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public void onUnbindMediaPlayState(AbstractMediaItemPresenter.ViewHolder vh)
```

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

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter.ViewHolder vh` | The ViewHolder to unbind from. |

### setActionPresenter

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public void setActionPresenter(Presenter actionPresenter)
```

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

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/leanback/widget/Presenter actionPresenter` | the presenter to be used for rendering a media item row actions. |

### setBackgroundColor

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public 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 |
|---|---|
| `int color` | The ARGB color used to set as the media list background color. |

### setHasMediaRowSeparator

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public void setHasMediaRowSeparator(boolean hasSeparator)
```

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

| Parameters |
|---|---|
| `boolean hasSeparator` | true if a separator should be displayed, false otherwise. |

### setThemeId

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public void setThemeId(int themeId)
```

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

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

## Protected methods

### createRowViewHolder

```
protected 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 |
|---|---|
| `https://developer.android.com/reference/android/view/ViewGroup.html parent` | The parent View for the Row's view holder. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder` | A ViewHolder for the Row's View. |

### getMediaPlayState

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
protected 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 `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter.ViewHolder#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 |
|---|---|
| `https://developer.android.com/reference/java/lang/Object.html item` | The media item |

| Returns |
|---|---|
| `int` | The current play state of this media item |

### isClippingChildren

```
protected boolean isClippingChildren()
```

Returns true if the Row view should clip its children. The clipChildren flag is set on view in `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#initializeRowViewHolder(androidx.leanback.widget.RowPresenter.ViewHolder)`. Note that Slide transition or explode transition need turn off clipChildren. Default value is false.

### onBindMediaDetails

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
protected abstract void onBindMediaDetails(
    AbstractMediaItemPresenter.ViewHolder vh,
    Object item
)
```

Binds the media item details to their views provided by the `https://developer.android.com/reference/androidx/leanback/widget/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 `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter.ViewHolder#getMediaItemNumberView()`, `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter.ViewHolder#getMediaItemNameView()`, and `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter.ViewHolder#getMediaItemDurationView()`, on the `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter.ViewHolder` provided as the argument `vh` of this presenter.

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter.ViewHolder vh` | The ViewHolder for this `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter`. |
| `https://developer.android.com/reference/java/lang/Object.html item` | The media item row object being presented. |

### onBindRowActions

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
protected void onBindRowActions(AbstractMediaItemPresenter.ViewHolder vh)
```

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

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter.ViewHolder vh` | ViewHolder for the media item. |

### onBindRowViewHolder

```
protected void onBindRowViewHolder(
    @NonNull RowPresenter.ViewHolder vh,
    @NonNull Object item
)
```

Binds the given row object to the given ViewHolder. Derived classes of `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter` overriding `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onBindRowViewHolder(androidx.leanback.widget.RowPresenter.ViewHolder,java.lang.Object)` must call through the super class's implementation of this method.

### onUnbindMediaDetails

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
protected void onUnbindMediaDetails(AbstractMediaItemPresenter.ViewHolder vh)
```

Unbinds the media item details from their views provided by the `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter`. This method can be overridden by the subclasses of this presenter if required.

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter.ViewHolder vh` | ViewHolder to unbind from. |