Leanback 界面工具包具有播放控件,可提供改进 用户体验。对于视频应用,传输控件支持视频拖动 以及前进和后退控件拖动显示屏时 以便快速浏览视频。
该库包含抽象类以及预构建的开箱即用型实现 为开发者提供更精细的控制使用预构建 您可以快速构建功能丰富的应用,而无需编写大量代码。 如果需要更多自定义设置,您可以扩展该库的任何预构建版本, 组件。
控件和播放器
Leanback UI 工具包将传输控件 UI 播放视频的播放器这是通过两个组件实现的: 一个播放支持 fragment,用于显示传输控件(以及 以及用于封装媒体播放器的播放器适配器。
播放 Fragment
应用的界面 Activity 应使用
PlaybackSupportFragment
或
VideoSupportFragment
。
两者都包含 Leanback 传输控件:
PlaybackSupportFragment
将其传输控件制作成动画,以根据需要隐藏/显示这些控件。VideoSupportFragment
扩展了PlaybackSupportFragment
并具有用于渲染视频的SurfaceView
。
你可以自定义
ObjectAdapter
来改进界面例如,使用
setAdapter()
添加“相关视频”。
PlayerAdapter
PlayerAdapter
是一个抽象类,
用于控制底层媒体播放器。开发者可以选择
预构建的 MediaPlayerAdapter
实现,或者编写
类自身的实现
将片段粘合在一起
您必须使用一些“控制粘合剂”用于连接播放 Fragment 。休闲椅 库提供了两种粘合剂:
PlaybackBannerControlGlue
绘制 “旧样式”的播放 Fragment 中放置传输控件, 位于不透明背景中(PlaybackBannerControlGlue
取代了PlaybackControlGlue
, 已弃用。)PlaybackTransportControlGlue
使用“新样式”以及透明背景
如果您希望应用支持视频拖动,则必须使用
PlaybackTransportControlGlue
。
您还需要指定一个“粘合主机”那个
将粘合剂粘合到播放上
Fragment,在界面中绘制传输控件并保持其状态,以及
将传输控制事件传回粘合剂。该主机必须与播放 Fragment 类型匹配。使用
PlaybackSupportFragmentGlueHost
:
一个 PlaybackFragment
,以及
VideoSupportFragmentGlueHost
以及
VideoFragment
。
下图显示了 leanback 运输控件的各个部件如何 组合在一起:
用于将应用粘合在一起的代码应该位于
PlaybackSupportFragment
或 VideoSupportFragment
,用于定义界面。
在以下
例如,应用构造一个 PlaybackTransportControlGlue
实例,
将其命名为playerGlue
并将其 VideoSupportFragment
连接到新创建的 MediaPlayerAdapter
。开始时间
这是一个 VideoSupportFragment
,设置代码调用 setHost()
以附加
VideoSupportFragmentGlueHost
到 playerGlue
。代码包含在类中
用于扩展 VideoSupportFragment
。
Kotlin
class MyVideoFragment : VideoSupportFragment() { fun onCreate(savedInstanceState: Bundle) { super.onCreate(savedInstanceState) val playerGlue = PlaybackTransportControlGlue(getActivity(), MediaPlayerAdapter(getActivity())) playerGlue.setHost(VideoSupportFragmentGlueHost(this)) playerGlue.addPlayerCallback(object : PlaybackGlue.PlayerCallback() { override fun onPreparedStateChanged(glue: PlaybackGlue) { if (glue.isPrepared()) { playerGlue.seekProvider = MySeekProvider() playerGlue.play() } } }) playerGlue.setSubtitle("Leanback artist") playerGlue.setTitle("Leanback team at work") val uriPath = "android.resource://com.example.android.leanback/raw/video" playerGlue.getPlayerAdapter().setDataSource(Uri.parse(uriPath)) } }
Java
public class MyVideoFragment extends VideoSupportFragment { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); final PlaybackTransportControlGlue<MediaPlayerAdapter> playerGlue = new PlaybackTransportControlGlue(getActivity(), new MediaPlayerAdapter(getActivity())); playerGlue.setHost(new VideoSupportFragmentGlueHost(this)); playerGlue.addPlayerCallback(new PlaybackGlue.PlayerCallback() { @Override public void onPreparedStateChanged(PlaybackGlue glue) { if (glue.isPrepared()) { playerGlue.setSeekProvider(new MySeekProvider()); playerGlue.play(); } } }); playerGlue.setSubtitle("Leanback artist"); playerGlue.setTitle("Leanback team at work"); String uriPath = "android.resource://com.example.android.leanback/raw/video"; playerGlue.getPlayerAdapter().setDataSource(Uri.parse(uriPath)); } }
请注意,设置代码还定义了 PlayerAdapter.Callback
,用于处理来自
媒体播放器。
自定义界面粘合剂
你可以自定义
PlaybackBannerControlGlue
和PlaybackTransportControlGlue
将
PlaybackControlsRow
。
自定义标题和描述
要自定义
播放控件, 覆盖
onCreateRowPresenter()
:
Kotlin
override fun onCreateRowPresenter(): PlaybackRowPresenter { return super.onCreateRowPresenter().apply { (this as? PlaybackTransportRowPresenter) ?.setDescriptionPresenter(MyCustomDescriptionPresenter()) } }
Java
@Override protected PlaybackRowPresenter onCreateRowPresenter() { PlaybackTransportRowPresenter presenter = (PlaybackTransportRowPresenter) super.onCreateRowPresenter(); presenter.setDescriptionPresenter(new MyCustomDescriptionPresenter()); return presenter; }
添加控件
控件粘合剂显示 PlaybackControlsRow
中的操作控件。
PlaybackControlsRow
中的操作
分为两组:主要操作和次要操作
操作。主要组的控件显示在拖动条上方,
次要分组显示在搜索栏下方。最初,只有一项主要操作
没有辅助操作
您可以通过替换操作向主要群组和次要群组添加操作
onCreatePrimaryActions()
和
onCreateSecondaryActions()
。
Kotlin
private lateinit var repeatAction: PlaybackControlsRow.RepeatAction private lateinit var pipAction: PlaybackControlsRow.PictureInPictureAction private lateinit var thumbsUpAction: PlaybackControlsRow.ThumbsUpAction private lateinit var thumbsDownAction: PlaybackControlsRow.ThumbsDownAction private lateinit var skipPreviousAction: PlaybackControlsRow.SkipPreviousAction private lateinit var skipNextAction: PlaybackControlsRow.SkipNextAction private lateinit var fastForwardAction: PlaybackControlsRow.FastForwardAction private lateinit var rewindAction: PlaybackControlsRow.RewindAction override fun onCreatePrimaryActions(primaryActionsAdapter: ArrayObjectAdapter) { // Order matters, super.onCreatePrimaryActions() will create the play / pause action. // Will display as follows: // play/pause, previous, rewind, fast forward, next // > /|| |< << >> >| super.onCreatePrimaryActions(primaryActionsAdapter) primaryActionsAdapter.apply { add(skipPreviousAction) add(rewindAction) add(fastForwardAction) add(skipNextAction) } } override fun onCreateSecondaryActions(adapter: ArrayObjectAdapter?) { super.onCreateSecondaryActions(adapter) adapter?.apply { add(thumbsDownAction) add(thumbsUpAction) } }
Java
private PlaybackControlsRow.RepeatAction repeatAction; private PlaybackControlsRow.PictureInPictureAction pipAction; private PlaybackControlsRow.ThumbsUpAction thumbsUpAction; private PlaybackControlsRow.ThumbsDownAction thumbsDownAction; private PlaybackControlsRow.SkipPreviousAction skipPreviousAction; private PlaybackControlsRow.SkipNextAction skipNextAction; private PlaybackControlsRow.FastForwardAction fastForwardAction; private PlaybackControlsRow.RewindAction rewindAction; @Override protected void onCreatePrimaryActions(ArrayObjectAdapter primaryActionsAdapter) { // Order matters, super.onCreatePrimaryActions() will create the play / pause action. // Will display as follows: // play/pause, previous, rewind, fast forward, next // > /|| |< << >> >| super.onCreatePrimaryActions(primaryActionsAdapter); primaryActionsAdapter.add(skipPreviousAction); primaryActionsAdapter.add(rewindAction); primaryActionsAdapter.add(fastForwardAction); primaryActionsAdapter.add(skipNextAction); } @Override protected void onCreateSecondaryActions(ArrayObjectAdapter adapter) { super.onCreateSecondaryActions(adapter); adapter.add(thumbsDownAction); adapter.add(thumbsUpAction); }
您必须覆盖
onActionClicked()
用于处理新操作。
Kotlin
override fun onActionClicked(action: Action) { when(action) { rewindAction -> { // Handle Rewind } fastForwardAction -> { // Handle FastForward } thumbsDownAction -> { // Handle ThumbsDown } thumbsUpAction -> { // Handle ThumbsUp } else -> // The superclass handles play/pause and delegates next/previous actions to abstract methods, // so those two methods should be overridden rather than handling the actions here. super.onActionClicked(action) } } override fun next() { // Skip to next item in playlist. } override fun previous() { // Skip to previous item in playlist. }
Java
@Override public void onActionClicked(Action action) { if (action == rewindAction) { // Handle Rewind } else if (action == fastForwardAction ) { // Handle FastForward } else if (action == thumbsDownAction) { // Handle ThumbsDown } else if (action == thumbsUpAction) { // Handle ThumbsUp } else { // The superclass handles play/pause and delegates next/previous actions to abstract methods, // so those two methods should be overridden rather than handling the actions here. super.onActionClicked(action); } } @Override public void next() { // Skip to next item in playlist. } @Override public void previous() { // Skip to previous item in playlist. }
在特殊情况下,您可能想要实现自己的
PlaybackTransportRowPresenter
使用
PlaybackSeekUi
。
视频拖动
如果应用使用 VideoSupportFragment
,并且您希望支持视频拖动。
您
需要提供 PlaybackSeekDataProvider
的实现。
该组件提供滚动时使用的视频缩略图。
您必须通过扩展
PlaybackSeekDataProvider
。
请参阅
<ph type="x-smartling-placeholder"></ph>
Leanback Showcase 应用。
,了解所有最新动态。