使用传输控件

使用 Compose 打造更优质的应用

使用适用于 Android TV OS 的 Jetpack Compose 通过最少的代码创建精美的界面。

<ph type="x-smartling-placeholder"></ph> Compose for TV →

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，用于定义界面。

在以下示例中，应用构建了一个名为 playerGlue 的 PlaybackTransportControlGlue 实例，并将其 VideoSupportFragment 连接到新创建的 MediaPlayerAdapter。由于这是一个 VideoSupportFragment，设置代码会调用 setHost() 以将 VideoSupportFragmentGlueHost 附加到 playerGlue。该代码包含在扩展 VideoSupportFragment 的类中。

KotlinJava

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))
  }
}

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()：

KotlinJava

override fun onCreateRowPresenter(): PlaybackRowPresenter {
    return super.onCreateRowPresenter().apply {
        (this as? PlaybackTransportRowPresenter)
                ?.setDescriptionPresenter(MyCustomDescriptionPresenter())
    }
}

@Override
protected PlaybackRowPresenter onCreateRowPresenter() {
  PlaybackTransportRowPresenter presenter = (PlaybackTransportRowPresenter) super.onCreateRowPresenter();
  presenter.setDescriptionPresenter(new MyCustomDescriptionPresenter());
  return presenter;
}

添加控件

控件粘合剂显示 PlaybackControlsRow 中的操作控件。

PlaybackControlsRow 中的操作分为两组：主要操作和次要操作。主要组的控件显示在拖动条上方， 次要分组显示在搜索栏下方。最初，只有一项主要操作 没有辅助操作

您可以通过替换 onCreatePrimaryActions() 和 onCreateSecondaryActions()，向主要操作和次要操作添加操作。

KotlinJava

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)
    }
}

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() 才能处理新操作。

KotlinJava

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.
}

@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 来实现自己的提供程序。请参阅 Leanback Showcase 应用中的示例。