界面自定义

Media3 提供了一个默认的 PlayerView，它提供了一些自定义选项。如需进一步自定义，应用开发者应实现自己的界面组件。

最佳实践

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

“播放/暂停”按钮

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

为了简化实现，Media3 提供了一些实用程序方法，用于确定要显示哪个按钮 (Util.shouldShowPlayButton) 和处理按钮按下动作 (Util.handlePlayPauseButtonAction)：

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

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

监听状态更新

界面组件需要添加 Player.Listener，才能获悉需要进行相应界面更新的状态更改。如需了解详情，请参阅监听播放事件。

刷新界面的成本可能很高，并且常常会同时有多个玩家活动。为避免在短时间内过于频繁地刷新界面，最好仅监听 onEvents 并据此触发界面更新：

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

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 实现的通用界面组件应检查可用的播放器命令，以显示或隐藏按钮，并避免调用不受支持的方法：

nextButton.isEnabled = player.isCommandAvailable(Player.COMMAND_SEEK_TO_NEXT)

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