界面自定义

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(Player.COMMAND_SEEK_TO_NEXT)

Java

nextButton.setEnabled(player.isCommandAvailable(Player.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.
}