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