Platform Android Studio Google Play Jetpack Docs News
Visão geral Guias Referência Amostras Design & Quality

PlaybackControlsRow

public class PlaybackControlsRow
extends Row

java.lang.Object
   ↳ androidx.leanback.widget.Row
     ↳ androidx.leanback.widget.PlaybackControlsRow

A Row of playback controls to be displayed by a PlaybackControlsRowPresenter. This row consists of some optional item detail, a series of primary actions, and an optional series of secondary actions.

Controls are specified via an ObjectAdapter containing one or more Actions.

Adapters should have their PresenterSelector set to an instance of ControlButtonPresenterSelector.

Summary

Nested classes

class PlaybackControlsRow.ClosedCaptioningAction

An action for displaying a CC (Closed Captioning) icon. 

class PlaybackControlsRow.FastForwardAction

An action displaying an icon for fast forward. 

class PlaybackControlsRow.HighQualityAction

An action for displaying a HQ (High Quality) icon. 

class PlaybackControlsRow.MoreActions

An action displaying an icon for "more actions". 

class PlaybackControlsRow.MultiAction

Base class for an action comprised of a series of icons. 

class PlaybackControlsRow.OnPlaybackProgressCallback

Listener for progress or duration change. 

class PlaybackControlsRow.PictureInPictureAction

An action displaying an icon for picture-in-picture. 

class PlaybackControlsRow.PlayPauseAction

An action displaying icons for play and pause. 

class PlaybackControlsRow.RepeatAction

An action for displaying three repeat states: none, one, or all. 

class PlaybackControlsRow.RewindAction

An action displaying an icon for rewind. 

class PlaybackControlsRow.ShuffleAction

An action for displaying a shuffle icon. 

class PlaybackControlsRow.SkipNextAction

An action displaying an icon for skip next. 

class PlaybackControlsRow.SkipPreviousAction

An action displaying an icon for skip previous. 

class PlaybackControlsRow.ThumbsAction

A base class for displaying a thumbs action. 

class PlaybackControlsRow.ThumbsDownAction

An action displaying an icon for thumbs down. 

class PlaybackControlsRow.ThumbsUpAction

An action displaying an icon for thumbs up. 

Public constructors

PlaybackControlsRow(Object item)

Constructor for a PlaybackControlsRow that displays some details from the given item.

PlaybackControlsRow()

Constructor for a PlaybackControlsRow that has no item details.

Public methods

Action getActionForKeyCode(ObjectAdapter adapter, int keyCode)

Returns the Action associated with the given keycode, or null if no associated action exists.

Action getActionForKeyCode(int keyCode)

Returns the Action associated with the given keycode, or null if no associated action exists.

long getBufferedPosition()

Returns the buffered progress of long type for the playback controls row.

int getBufferedProgress()

This method is deprecated. Use getBufferedPosition()

long getBufferedProgressLong()

This method is deprecated. Use getBufferedPosition()

long getCurrentPosition()

Returns the current time in milliseconds of long type for playback controls row.

int getCurrentTime()

This method is deprecated. Use getCurrentPosition()

long getCurrentTimeLong()

This method is deprecated. Use getCurrentPosition()

long getDuration()

Returns duration in milliseconds.

final Drawable getImageDrawable()

Returns the image Drawable of this row.

final Object getItem()

Returns the main item for the details page.

final ObjectAdapter getPrimaryActionsAdapter()

Returns the primary actions ObjectAdapter.

final ObjectAdapter getSecondaryActionsAdapter()

Returns the secondary actions ObjectAdapter.

int getTotalTime()

This method is deprecated. use getDuration()

long getTotalTimeLong()

This method is deprecated. use getDuration()

void setBufferedPosition(long ms)

Sets the buffered progress for the playback controls row.

void setBufferedProgress(int ms)

This method is deprecated. Use setBufferedPosition(long)

void setBufferedProgressLong(long ms)

This method is deprecated. Use setBufferedPosition(long)

void setCurrentPosition(long ms)

Sets the current time in milliseconds for the playback controls row.

void setCurrentTime(int ms)

This method is deprecated. use setCurrentPosition(long)

void setCurrentTimeLong(long ms)

This method is deprecated. use setCurrentPosition(long)

void setDuration(long ms)

Sets the total time in milliseconds (long type) for the playback controls row.

final void setImageBitmap(Context context, Bitmap bm)

Sets a Bitmap for this row.

final void setImageDrawable(Drawable drawable)

Sets a {link @Drawable} image for this row.

void setOnPlaybackProgressChangedListener(PlaybackControlsRow.OnPlaybackProgressCallback listener)

Sets a listener to be called when the playback state changes.

final void setPrimaryActionsAdapter(ObjectAdapter adapter)

Sets the primary actions ObjectAdapter.

final void setSecondaryActionsAdapter(ObjectAdapter adapter)

Sets the secondary actions ObjectAdapter.

void setTotalTime(int ms)

This method is deprecated. Use setDuration(long)

void setTotalTimeLong(long ms)

This method is deprecated. Use setDuration(long)

Inherited methods

Public constructors

PlaybackControlsRow

public PlaybackControlsRow (Object item)

Constructor for a PlaybackControlsRow that displays some details from the given item.

Parameters
item Object: The main item for the row.

PlaybackControlsRow

public PlaybackControlsRow ()

Constructor for a PlaybackControlsRow that has no item details.

Public methods

getActionForKeyCode

public Action getActionForKeyCode (ObjectAdapter adapter, 
                int keyCode)

Returns the Action associated with the given keycode, or null if no associated action exists.

Parameters
adapter ObjectAdapter

keyCode int

Returns
Action

getActionForKeyCode

public Action getActionForKeyCode (int keyCode)

Returns the Action associated with the given keycode, or null if no associated action exists. Searches the primary adapter first, then the secondary adapter.

Parameters
keyCode int

Returns
Action

getBufferedPosition

public long getBufferedPosition ()

Returns the buffered progress of long type for the playback controls row.

Returns
long

getBufferedProgress

public int getBufferedProgress ()

This method is deprecated.
Use getBufferedPosition()

Returns the buffered progress for the playback controls row.

Returns
int

Throws
ArithmeticException If buffered progress in milliseconds overflows int.

getBufferedProgressLong

public long getBufferedProgressLong ()

This method is deprecated.
Use getBufferedPosition()

Returns the buffered progress of long type for the playback controls row.

Returns
long

getCurrentPosition

public long getCurrentPosition ()

Returns the current time in milliseconds of long type for playback controls row.

Returns
long

getCurrentTime

public int getCurrentTime ()

This method is deprecated.
Use getCurrentPosition()

Returns the current time in milliseconds for the playback controls row.

Returns
int

Throws
ArithmeticException If current time in milliseconds overflows int.

getCurrentTimeLong

public long getCurrentTimeLong ()

This method is deprecated.
Use getCurrentPosition()

Returns the current time in milliseconds of long type for playback controls row.

Returns
long

getDuration

public long getDuration ()

Returns duration in milliseconds.

Returns
long Duration in milliseconds.

getImageDrawable

public final Drawable getImageDrawable ()

Returns the image Drawable of this row.

Returns
Drawable The overview's image drawable, or null if no drawable has been assigned.

getItem

public final Object getItem ()

Returns the main item for the details page.

Returns
Object

getPrimaryActionsAdapter

public final ObjectAdapter getPrimaryActionsAdapter ()

Returns the primary actions ObjectAdapter.

Returns
ObjectAdapter

getSecondaryActionsAdapter

public final ObjectAdapter getSecondaryActionsAdapter ()

Returns the secondary actions ObjectAdapter.

Returns
ObjectAdapter

getTotalTime

public int getTotalTime ()

This method is deprecated.
use getDuration()

Returns the total time in milliseconds for the playback controls row.

Returns
int

Throws
ArithmeticException If total time in milliseconds overflows int.

getTotalTimeLong

public long getTotalTimeLong ()

This method is deprecated.
use getDuration()

Returns the total time in milliseconds of long type for the playback controls row.

Returns
long

setBufferedPosition

public void setBufferedPosition (long ms)

Sets the buffered progress for the playback controls row.

Parameters
ms long: Buffered progress in milliseconds of long type.

setBufferedProgress

public void setBufferedProgress (int ms)

This method is deprecated.
Use setBufferedPosition(long)

Sets the buffered progress for the playback controls row. If this row is bound to a view, the view will automatically be updated to reflect the new value.

Parameters
ms int

setBufferedProgressLong

public void setBufferedProgressLong (long ms)

This method is deprecated.
Use setBufferedPosition(long)

Sets the buffered progress for the playback controls row.

Parameters
ms long: Buffered progress in milliseconds of long type.

setCurrentPosition

public void setCurrentPosition (long ms)

Sets the current time in milliseconds for the playback controls row. If this row is bound to a view, the view will automatically be updated to reflect the new value.

Parameters
ms long: Current time in milliseconds of long type.

setCurrentTime

public void setCurrentTime (int ms)

This method is deprecated.
use setCurrentPosition(long)

Sets the current time in milliseconds for the playback controls row. If this row is bound to a view, the view will automatically be updated to reflect the new value.

Parameters
ms int

setCurrentTimeLong

public void setCurrentTimeLong (long ms)

This method is deprecated.
use setCurrentPosition(long)

Sets the current time in milliseconds for playback controls row in long type.

Parameters
ms long: Current time in milliseconds of long type.

setDuration

public void setDuration (long ms)

Sets the total time in milliseconds (long type) for the playback controls row. If this row is bound to a view, the view will automatically be updated to reflect the new value.

Parameters
ms long: Total time in milliseconds of long type.

setImageBitmap

public final void setImageBitmap (Context context, 
                Bitmap bm)

Sets a Bitmap for this row.

If set after the row has been bound to a view, the adapter must be notified that this row has changed.

Parameters
context Context: The context to retrieve display metrics from.
bm Bitmap: The bitmap to set.

setImageDrawable

public final void setImageDrawable (Drawable drawable)

Sets a {link @Drawable} image for this row.

If set after the row has been bound to a view, the adapter must be notified that this row has changed.

Parameters
drawable Drawable: The drawable to set.

setOnPlaybackProgressChangedListener

public void setOnPlaybackProgressChangedListener (PlaybackControlsRow.OnPlaybackProgressCallback listener)

Sets a listener to be called when the playback state changes.

Parameters
listener PlaybackControlsRow.OnPlaybackProgressCallback

setPrimaryActionsAdapter

public final void setPrimaryActionsAdapter (ObjectAdapter adapter)

Sets the primary actions ObjectAdapter.

If set after the row has been bound to a view, the adapter must be notified that this row has changed.

Parameters
adapter ObjectAdapter

setSecondaryActionsAdapter

public final void setSecondaryActionsAdapter (ObjectAdapter adapter)

Sets the secondary actions ObjectAdapter.

If set after the row has been bound to a view, the adapter must be notified that this row has changed.

Parameters
adapter ObjectAdapter

setTotalTime

public void setTotalTime (int ms)

This method is deprecated.
Use setDuration(long)

Sets the total time in milliseconds for the playback controls row.

If set after the row has been bound to a view, the adapter must be notified that this row has changed.

Parameters
ms int

setTotalTimeLong

public void setTotalTimeLong (long ms)

This method is deprecated.
Use setDuration(long)

Sets the total time in milliseconds (long type) for the playback controls row.

Parameters
ms long: Total time in milliseconds of long type.