界面自定义

Media3 提供了一个默认的 PlayerView，其中提供了一些自定义选项。对于任何进一步的定制，应用开发者都需要实现自己的界面组件。

最佳做法

在实现连接到 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.
}