界面自定义

Media3 提供了一个默认的 PlayerView，其中提供了一些自定义 选项。

替换可绘制对象

PlayerView 使用 PlayerControlView 来显示播放控件和 进度条。PlayerControlView 使用的可绘制对象可以被 应用中定义的同名可绘制对象替换。如需查看可以替换的控件可绘制对象的列表，请参阅 PlayerControlView文档。

如需进行任何进一步的自定义，应用开发者需要实现自己的 界面组件。不过，下面提供了一些最佳实践，可帮助您入门 。

最佳实践

在实现连接到 Media3 Player（例如 ExoPlayer、MediaController 或自定义 Player 实现）的媒体界面时，建议应用 遵循以下最佳实践，以获得最佳界面体验。

播放/暂停按钮

播放和暂停按钮并不直接对应于单个播放器状态。 例如，即使播放器未暂停，用户也应该能够在播放结束后或失败后重新开始播放 。

为了简化实现，Media3 提供了实用程序方法来决定要显示哪个 按钮 (Util.shouldShowPlayButton)，并处理按钮按下操作 (Util.handlePlayPauseButtonAction)：

Kotlin

val shouldShowPlayButton: Boolean = Util.shouldShowPlayButton(player)
playPauseButton.setImageDrawable(if (shouldShowPlayButton) playDrawable else pauseDrawable)
playPauseButton.setOnClickListener { Util.handlePlayPauseButtonAction(player) }

Java

boolean shouldShowPlayButton = Util.shouldShowPlayButton(player);
playPauseButton.setImageDrawable(shouldShowPlayButton ? playDrawable : pauseDrawable);
playPauseButton.setOnClickListener(view -> Util.handlePlayPauseButtonAction(player));

监听状态更新

界面组件需要添加 Player.Listener，以便在需要进行相应界面更新的状态 发生变化时收到通知。如需了解详情，请参阅监听播放 事件。

刷新界面可能代价高昂，并且多个播放器事件通常会同时到达 。为了避免在短时间内过于频繁地刷新界面，通常最好只监听 onEvents 并从中触发界面更新：

Kotlin

player.addListener(object : Player.Listener{
  override fun onEvents(player: Player, events: Player.Events){
    if (events.containsAny(
        Player.EVENT_PLAY_WHEN_READY_CHANGED,
        Player.EVENT_PLAYBACK_STATE_CHANGED,
        Player.EVENT_PLAYBACK_SUPPRESSION_REASON_CHANGED)) {
      updatePlayPauseButton()
    }
    if (events.containsAny(Player.EVENT_REPEAT_MODE_CHANGED)) {
      updateRepeatModeButton()
    }
  }
})

Java

player.addListener(new Player.Listener() {
  @Override
  public void onEvents(Player player, Player.Events events) {
    if (events.containsAny(
        Player.EVENT_PLAY_WHEN_READY_CHANGED,
        Player.EVENT_PLAYBACK_STATE_CHANGED,
        Player.EVENT_PLAYBACK_SUPPRESSION_REASON_CHANGED)) {
      updatePlayPauseButton();
    }
    if (events.containsAny(Player.EVENT_REPEAT_MODE_CHANGED)) {
      updateRepeatModeButton();
    }
  }
});

处理可用命令

可能需要使用不同 Player 实现的通用界面组件应检查可用的播放器命令，以显示或隐藏 按钮并避免调用不受支持的方法：

Kotlin

nextButton.isEnabled = player.isCommandAvailable(COMMAND_SEEK_TO_NEXT)

Java

nextButton.setEnabled(player.isCommandAvailable(COMMAND_SEEK_TO_NEXT));

首帧快门和图片显示

当界面组件显示视频或图片时，它通常会使用占位符 快门视图，直到真正的首帧或图片可用为止。此外， 混合视频和图片播放需要在 适当的时间隐藏和显示图片视图。

处理这些更新的常见模式是监听 Player.Listener.onEvents()，以了解所选曲目的任何变化 (EVENT_TRACKS_CHANGED)以及何时渲染了第一个视频帧 (EVENT_RENDERED_FIRST_FRAME)，并监听ImageOutput.onImageAvailable() ，以了解何时有新图片可用：

Kotlin

override fun onEvents(player: Player, events: Player.Events) {
  if (events.contains(Player.EVENT_TRACKS_CHANGED)) {
    // If no video or image track: show shutter, hide image view.
    // Otherwise: do nothing to wait for first frame or image.
  }
  if (events.contains(Player.EVENT_RENDERED_FIRST_FRAME)) {
    // Hide shutter, hide image view.
  }
}

override fun onImageAvailable(presentationTimeUs: Long, bitmap: Bitmap) {
  // Show shutter, set image and show image view.
}

Java

@Override
public void onEvents(Player player, Events events) {
  if (events.contains(Player.EVENT_TRACKS_CHANGED)) {
    // If no video or image track: show shutter, hide image view.
    // Otherwise: do nothing to wait for first frame or image.
  }
  if (events.contains(Player.EVENT_RENDERED_FIRST_FRAME)) {
    // Hide shutter, hide image view.
  }
}

@Override
public void onImageAvailable(long presentationTimeUs, Bitmap bitmap) {
  // Show shutter, set image and show image view.
}