Настройки интерфейса

В Media3 есть стандартный класс PlayerView, который предоставляет некоторые возможности настройки.

Переопределение графических объектов

PlayerView использует PlayerControlView для отображения элементов управления воспроизведением и индикатора выполнения. Графические объекты, используемые PlayerControlView, можно переопределить графическими объектами с теми же названиями, которые определены в вашем приложении. Список графических объектов, которые можно переопределить, приведен в документации по PlayerControlView.

Для дальнейшей настройки разработчикам приложений необходимо реализовать собственные компоненты пользовательского интерфейса. Однако вы можете ознакомиться с нашими рекомендациями.

Рекомендации

При реализации пользовательского интерфейса мультимедиа, который подключается к 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) }
UiCustomization.kt

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

Прослушивание обновлений состояния

Компонент пользовательского интерфейса должен добавить 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()
      }
    }
  }
)
UiCustomization.kt

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();
        }
      }
    });
UiCustomization.java

Обработка доступных команд

Компонент пользовательского интерфейса общего назначения, который может работать с разными реализациями Player, должен проверять доступные команды проигрывателя, чтобы показывать или скрывать кнопки и не вызывать неподдерживаемые методы:

nextButton.isEnabled = player.isCommandAvailable(COMMAND_SEEK_TO_NEXT)
UiCustomization.kt

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

Затвор первого кадра и показ изображения

Когда компонент интерфейса показывает видео или изображения, он обычно использует заполнитель, пока не станет доступен первый кадр или изображение. Кроме того, при смешанном воспроизведении видео и изображений необходимо скрывать и показывать изображение в нужное время.

Обычно для обработки таких обновлений используется прослушивание Player.Listener.onEvents() для любых изменений в выбранных треках (EVENT_TRACKS_CHANGED) и для момента, когда первый кадр видео был отрисован (EVENT_RENDERED_FIRST_FRAME), а также ImageOutput.onImageAvailable() для момента, когда доступно новое изображение:

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.
}
UiCustomization.kt

@Override
public void onEvents(Player 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.
}
UiCustomization.java