belongs to Maven artifact com.android.support:leanback-v17:28.0.0-alpha1
PlaybackSupportFragment
public
class
PlaybackSupportFragment
extends Fragment
java.lang.Object | ||
↳ | android.support.v4.app.Fragment | |
↳ | android.support.v17.leanback.app.PlaybackSupportFragment |
Known Direct Subclasses |
A fragment for displaying playback controls and related content.
A PlaybackSupportFragment renders the elements of its ObjectAdapter
as a set
of rows in a vertical list. The Adapter's PresenterSelector
must maintain subclasses
of RowPresenter
.
A playback row is a row rendered by PlaybackRowPresenter
.
App can call setPlaybackRow(Row)
to set playback row for the first element of adapter.
App can call setPlaybackRowPresenter(PlaybackRowPresenter)
to set presenter for it.
setPlaybackRow(Row)
and setPlaybackRowPresenter(PlaybackRowPresenter)
are
optional, app can pass playback row and PlaybackRowPresenter in the adapter using
setAdapter(ObjectAdapter)
.
Auto hide controls upon playing: best practice is calling
setControlsOverlayAutoHideEnabled(boolean)
upon play/pause. The auto hiding timer will
be cancelled upon tickle()
triggered by input event.
Summary
Constants | |
---|---|
int |
BG_DARK
A dark translucent background. |
int |
BG_LIGHT
A light translucent background. |
int |
BG_NONE
No background. |
Public constructors | |
---|---|
PlaybackSupportFragment()
|
Public methods | |
---|---|
void
|
fadeOut()
This method was deprecated
in API level 26.1.0.
Call |
ObjectAdapter
|
getAdapter()
|
int
|
getBackgroundType()
Returns the background type. |
ProgressBarManager
|
getProgressBarManager()
Returns the ProgressBarManager that will show or hide progress bar in
|
void
|
hideControlsOverlay(boolean runAnimation)
Hide controls overlay. |
boolean
|
isControlsOverlayAutoHideEnabled()
Returns true if controls will be auto hidden after a delay when fragment is resumed. |
boolean
|
isControlsOverlayVisible()
Returns true if controls overlay is visible, false otherwise. |
boolean
|
isFadingEnabled()
This method was deprecated
in API level 26.1.0.
Uses |
void
|
notifyPlaybackRowChanged()
Updates the ui when the row data changes. |
void
|
onCreate(Bundle savedInstanceState)
Called to do initial creation of a fragment. |
View
|
onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)
Called to have the fragment instantiate its user interface view. |
void
|
onDestroy()
Called when the fragment is no longer in use. |
void
|
onDestroyView()
Called when the view previously created by |
void
|
onPause()
Called when the Fragment is no longer resumed. |
void
|
onResume()
Called when the fragment is visible to the user and actively running. |
void
|
onStart()
Called when the Fragment is visible to the user. |
void
|
onStop()
Called when the Fragment is no longer started. |
void
|
onViewCreated(View view, Bundle savedInstanceState)
Called immediately after |
void
|
setAdapter(ObjectAdapter adapter)
Sets the list of rows for the fragment. |
void
|
setBackgroundType(int type)
Sets the background type. |
void
|
setControlsOverlayAutoHideEnabled(boolean enabled)
Enables or disables auto hiding controls overlay after a short delay fragment is resumed. |
void
|
setFadingEnabled(boolean enabled)
This method was deprecated
in API level 26.1.0.
Uses |
void
|
setHostCallback(PlaybackGlueHost.HostCallback hostCallback)
Sets the |
void
|
setOnItemViewClickedListener(BaseOnItemViewClickedListener listener)
This listener is called every time there is a click in |
void
|
setOnItemViewSelectedListener(BaseOnItemViewSelectedListener listener)
This listener is called every time there is a selection in |
final
void
|
setOnKeyInterceptListener(View.OnKeyListener handler)
Sets the input event handler. |
void
|
setOnPlaybackItemViewClickedListener(BaseOnItemViewClickedListener listener)
Sets the |
void
|
setPlaybackRow(Row row)
Sets the playback row for the playback controls. |
void
|
setPlaybackRowPresenter(PlaybackRowPresenter presenter)
Sets the presenter for rendering the playback row set by |
void
|
setPlaybackSeekUiClient(PlaybackSeekUi.Client client)
Interface to be implemented by UI widget to support PlaybackSeekUi. |
void
|
setSelectedPosition(int position)
Sets the selected row position with smooth animation. |
void
|
setSelectedPosition(int position, boolean smooth)
Sets the selected row position. |
void
|
showControlsOverlay(boolean runAnimation)
Show controls overlay. |
void
|
tickle()
Tickles the playback controls. |
Protected methods | |
---|---|
void
|
onBufferingStateChanged(boolean start)
Called when media has start or stop buffering. |
void
|
onError(int errorCode, CharSequence errorMessage)
Called when media has error. |
void
|
onVideoSizeChanged(int videoWidth, int videoHeight)
Called when size of the video changes. |
Inherited methods | |
---|---|
From
class
android.support.v4.app.Fragment
| |
From
class
java.lang.Object
| |
From
interface
android.content.ComponentCallbacks
| |
From
interface
android.view.View.OnCreateContextMenuListener
| |
From
interface
android.arch.lifecycle.LifecycleOwner
| |
From
interface
android.arch.lifecycle.ViewModelStoreOwner
|
Constants
BG_DARK
int BG_DARK
A dark translucent background.
Constant Value: 1 (0x00000001)
BG_LIGHT
int BG_LIGHT
A light translucent background.
Constant Value: 2 (0x00000002)
Public constructors
Public methods
fadeOut
void fadeOut ()
This method was deprecated
in API level 26.1.0.
Call hideControlsOverlay(boolean)
Fades out the playback overlay immediately.
getBackgroundType
int getBackgroundType ()
Returns the background type.
Returns | |
---|---|
int |
getProgressBarManager
ProgressBarManager getProgressBarManager ()
Returns the ProgressBarManager that will show or hide progress bar in
onBufferingStateChanged(boolean)
.
Returns | |
---|---|
ProgressBarManager |
The ProgressBarManager that will show or hide progress bar in
onBufferingStateChanged(boolean) .
|
hideControlsOverlay
void hideControlsOverlay (boolean runAnimation)
Hide controls overlay.
Parameters | |
---|---|
runAnimation |
boolean : True to run animation, false otherwise.
|
isControlsOverlayAutoHideEnabled
boolean isControlsOverlayAutoHideEnabled ()
Returns true if controls will be auto hidden after a delay when fragment is resumed.
Returns | |
---|---|
boolean |
isControlsOverlayVisible
boolean isControlsOverlayVisible ()
Returns true if controls overlay is visible, false otherwise.
Returns | |
---|---|
boolean |
True if controls overlay is visible, false otherwise. |
isFadingEnabled
boolean isFadingEnabled ()
This method was deprecated
in API level 26.1.0.
Uses isControlsOverlayAutoHideEnabled()
Returns | |
---|---|
boolean |
notifyPlaybackRowChanged
void notifyPlaybackRowChanged ()
Updates the ui when the row data changes.
onCreate
void onCreate (Bundle savedInstanceState)
Called to do initial creation of a fragment. This is called after
onAttach(Activity)
and before
onCreateView(LayoutInflater, ViewGroup, Bundle)
.
Note that this can be called while the fragment's activity is
still in the process of being created. As such, you can not rely
on things like the activity's content view hierarchy being initialized
at this point. If you want to do work once the activity itself is
created, see onActivityCreated(Bundle)
.
Any restored child fragments will be created before the base
Fragment.onCreate
method returns.
Parameters | |
---|---|
savedInstanceState |
Bundle : If the fragment is being re-created from
a previous saved state, this is the state.
|
onCreateView
View onCreateView (LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)
Called to have the fragment instantiate its user interface view.
This is optional, and non-graphical fragments can return null (which
is the default implementation). This will be called between
onCreate(Bundle)
and onActivityCreated(Bundle)
.
If you return a View from here, you will later be called in
onDestroyView()
when the view is being released.
Parameters | |
---|---|
inflater |
LayoutInflater : The LayoutInflater object that can be used to inflate
any views in the fragment, |
container |
ViewGroup : If non-null, this is the parent view that the fragment's
UI should be attached to. The fragment should not add the view itself,
but this can be used to generate the LayoutParams of the view. |
savedInstanceState |
Bundle : If non-null, this fragment is being re-constructed
from a previous saved state as given here. |
Returns | |
---|---|
View |
Return the View for the fragment's UI, or null. |
onDestroy
void onDestroy ()
Called when the fragment is no longer in use. This is called
after onStop()
and before onDetach()
.
onDestroyView
void onDestroyView ()
Called when the view previously created by onCreateView(LayoutInflater, ViewGroup, Bundle)
has
been detached from the fragment. The next time the fragment needs
to be displayed, a new view will be created. This is called
after onStop()
and before onDestroy()
. It is called
regardless of whether onCreateView(LayoutInflater, ViewGroup, Bundle)
returned a
non-null view. Internally it is called after the view's state has
been saved but before it has been removed from its parent.
onPause
void onPause ()
Called when the Fragment is no longer resumed. This is generally
tied to Activity.onPause
of the containing
Activity's lifecycle.
onResume
void onResume ()
Called when the fragment is visible to the user and actively running.
This is generally
tied to Activity.onResume
of the containing
Activity's lifecycle.
onStart
void onStart ()
Called when the Fragment is visible to the user. This is generally
tied to Activity.onStart
of the containing
Activity's lifecycle.
onStop
void onStop ()
Called when the Fragment is no longer started. This is generally
tied to Activity.onStop
of the containing
Activity's lifecycle.
onViewCreated
void onViewCreated (View view, Bundle savedInstanceState)
Called immediately after onCreateView(LayoutInflater, ViewGroup, Bundle)
has returned, but before any saved state has been restored in to the view.
This gives subclasses a chance to initialize themselves once
they know their view hierarchy has been completely created. The fragment's
view hierarchy is not however attached to its parent at this point.
Parameters | |
---|---|
view |
View : The View returned by onCreateView(LayoutInflater, ViewGroup, Bundle) . |
savedInstanceState |
Bundle : If non-null, this fragment is being re-constructed
from a previous saved state as given here.
|
setAdapter
void setAdapter (ObjectAdapter adapter)
Sets the list of rows for the fragment. A default ClassPresenterSelector
will be
created if getPresenterSelector()
is null. if user provides
setPlaybackRow(Row)
and setPlaybackRowPresenter(PlaybackRowPresenter)
,
the row and presenter will be set onto the adapter.
Parameters | |
---|---|
adapter |
ObjectAdapter : The adapter that contains related rows and optional playback row.
|
setBackgroundType
void setBackgroundType (int type)
Sets the background type.
Parameters | |
---|---|
type |
int : One of BG_LIGHT, BG_DARK, or BG_NONE.
|
setControlsOverlayAutoHideEnabled
void setControlsOverlayAutoHideEnabled (boolean enabled)
Enables or disables auto hiding controls overlay after a short delay fragment is resumed.
If enabled and fragment is resumed, the view will fade out after a time period.
tickle()
will kill the timer, next time fragment is resumed,
the timer will be started again if isControlsOverlayAutoHideEnabled()
is true.
Parameters | |
---|---|
enabled |
boolean |
setFadingEnabled
void setFadingEnabled (boolean enabled)
This method was deprecated
in API level 26.1.0.
Uses setControlsOverlayAutoHideEnabled(boolean)
Parameters | |
---|---|
enabled |
boolean |
setHostCallback
void setHostCallback (PlaybackGlueHost.HostCallback hostCallback)
Sets the PlaybackGlueHost.HostCallback
. Implementor of this interface will
take appropriate actions to take action when the hosting fragment starts/stops processing.
Parameters | |
---|---|
hostCallback |
PlaybackGlueHost.HostCallback |
setOnItemViewClickedListener
void setOnItemViewClickedListener (BaseOnItemViewClickedListener listener)
This listener is called every time there is a click in RowsSupportFragment
. This can
be used by users to take additional actions such as animations.
Parameters | |
---|---|
listener |
BaseOnItemViewClickedListener |
setOnItemViewSelectedListener
void setOnItemViewSelectedListener (BaseOnItemViewSelectedListener listener)
This listener is called every time there is a selection in RowsSupportFragment
. This can
be used by users to take additional actions such as animations.
Parameters | |
---|---|
listener |
BaseOnItemViewSelectedListener |
setOnKeyInterceptListener
void setOnKeyInterceptListener (View.OnKeyListener handler)
Sets the input event handler.
Parameters | |
---|---|
handler |
View.OnKeyListener |
setOnPlaybackItemViewClickedListener
void setOnPlaybackItemViewClickedListener (BaseOnItemViewClickedListener listener)
Sets the BaseOnItemViewClickedListener
that would be invoked for clicks
only on PlaybackRowPresenter.ViewHolder
.
Parameters | |
---|---|
listener |
BaseOnItemViewClickedListener |
setPlaybackRow
void setPlaybackRow (Row row)
Sets the playback row for the playback controls. The row will be set as first element
of adapter if the adapter is ArrayObjectAdapter
or SparseArrayObjectAdapter
.
Parameters | |
---|---|
row |
Row : The row that represents the playback.
|
setPlaybackRowPresenter
void setPlaybackRowPresenter (PlaybackRowPresenter presenter)
Sets the presenter for rendering the playback row set by setPlaybackRow(Row)
. If
adapter does not set a PresenterSelector
, setAdapter(ObjectAdapter)
will
create a ClassPresenterSelector
by default and map from the row object class to this
PlaybackRowPresenter
.
Parameters | |
---|---|
presenter |
PlaybackRowPresenter : Presenter used to render setPlaybackRow(Row) .
|
setPlaybackSeekUiClient
void setPlaybackSeekUiClient (PlaybackSeekUi.Client client)
Interface to be implemented by UI widget to support PlaybackSeekUi.
Parameters | |
---|---|
client |
PlaybackSeekUi.Client |
setSelectedPosition
void setSelectedPosition (int position)
Sets the selected row position with smooth animation.
Parameters | |
---|---|
position |
int |
setSelectedPosition
void setSelectedPosition (int position, boolean smooth)
Sets the selected row position.
Parameters | |
---|---|
position |
int |
smooth |
boolean |
showControlsOverlay
void showControlsOverlay (boolean runAnimation)
Show controls overlay.
Parameters | |
---|---|
runAnimation |
boolean : True to run animation, false otherwise.
|
tickle
void tickle ()
Tickles the playback controls. Fades in the view if it was faded out. tickle()
will
also kill the timer created by setControlsOverlayAutoHideEnabled(boolean)
. When
next time fragment is resumed, the timer will be started again if
isControlsOverlayAutoHideEnabled()
is true. In most cases app does not need call
this method, tickling on input events is handled by the fragment.
Protected methods
onBufferingStateChanged
void onBufferingStateChanged (boolean start)
Called when media has start or stop buffering. App may override. The default initial state is not buffering.
Parameters | |
---|---|
start |
boolean : True for buffering start, false otherwise.
|
onError
void onError (int errorCode, CharSequence errorMessage)
Called when media has error. App may override.
Parameters | |
---|---|
errorCode |
int : Optional error code for specific implementation. |
errorMessage |
CharSequence : Optional error message for specific implementation.
|
onVideoSizeChanged
void onVideoSizeChanged (int videoWidth, int videoHeight)
Called when size of the video changes. App may override.
Parameters | |
---|---|
videoWidth |
int : Intrinsic width of video |
videoHeight |
int : Intrinsic height of video
|
Interfaces
- BrowseFragment.FragmentHost
- BrowseFragment.MainFragmentAdapterProvider
- BrowseFragment.MainFragmentRowsAdapterProvider
- BrowseSupportFragment.FragmentHost
- BrowseSupportFragment.MainFragmentAdapterProvider
- BrowseSupportFragment.MainFragmentRowsAdapterProvider
- HeadersFragment.OnHeaderClickedListener
- HeadersFragment.OnHeaderViewSelectedListener
- HeadersSupportFragment.OnHeaderClickedListener
- HeadersSupportFragment.OnHeaderViewSelectedListener
- SearchFragment.SearchResultProvider
- SearchSupportFragment.SearchResultProvider
Classes
- BackgroundManager
- BaseFragment
- BaseSupportFragment
- BrandedFragment
- BrandedSupportFragment
- BrowseFragment
- BrowseFragment.BrowseTransitionListener
- BrowseFragment.FragmentFactory
- BrowseFragment.ListRowFragmentFactory
- BrowseFragment.MainFragmentAdapter
- BrowseFragment.MainFragmentAdapterRegistry
- BrowseFragment.MainFragmentRowsAdapter
- BrowseSupportFragment
- BrowseSupportFragment.BrowseTransitionListener
- BrowseSupportFragment.FragmentFactory
- BrowseSupportFragment.ListRowFragmentFactory
- BrowseSupportFragment.MainFragmentAdapter
- BrowseSupportFragment.MainFragmentAdapterRegistry
- BrowseSupportFragment.MainFragmentRowsAdapter
- DetailsFragment
- DetailsFragmentBackgroundController
- DetailsSupportFragment
- DetailsSupportFragmentBackgroundController
- ErrorFragment
- ErrorSupportFragment
- GuidedStepFragment
- GuidedStepSupportFragment
- HeadersFragment
- HeadersSupportFragment
- OnboardingFragment
- OnboardingSupportFragment
- PlaybackFragment
- PlaybackFragmentGlueHost
- PlaybackSupportFragment
- PlaybackSupportFragmentGlueHost
- ProgressBarManager
- RowsFragment
- RowsFragment.MainFragmentAdapter
- RowsFragment.MainFragmentRowsAdapter
- RowsSupportFragment
- RowsSupportFragment.MainFragmentAdapter
- RowsSupportFragment.MainFragmentRowsAdapter
- SearchFragment
- SearchSupportFragment
- VerticalGridFragment
- VerticalGridSupportFragment
- VideoFragment
- VideoFragmentGlueHost
- VideoSupportFragment
- VideoSupportFragmentGlueHost