Personalizzazioni dell'interfaccia utente

Media3 fornisce un PlayerView predefinito che offre alcune opzioni di personalizzazione.

Esegui l'override dei drawable

PlayerView utilizza PlayerControlView per visualizzare i controlli di riproduzione e la barra di avanzamento. Gli elementi drawable utilizzati da PlayerControlView possono essere sostituiti da elementi drawable con gli stessi nomi definiti nella tua applicazione. Consulta la documentazione di PlayerControlView per un elenco di elementi drawable di controllo di cui è possibile eseguire l'override.

Per qualsiasi ulteriore personalizzazione, gli sviluppatori di app devono implementare i propri componenti UI. Tuttavia, di seguito sono riportate alcune best practice che possono aiutarti a iniziare.

Best practice

Quando implementano un'UI multimediale che si connette a un Player Media3 (ad esempio ExoPlayer, MediaController o un'implementazione Player personalizzata), le app devono seguire queste best practice per un'esperienza UI ottimale.

Pulsante Riproduci/Pausa

Il pulsante Riproduci/Metti in pausa non corrisponde direttamente a un singolo stato del player. Ad esempio, un utente dovrebbe essere in grado di riavviare la riproduzione dopo che è terminata o non è riuscita, anche se il player non è in pausa.

Per semplificare l'implementazione, Media3 fornisce metodi di utilità per decidere quale pulsante mostrare (Util.shouldShowPlayButton) e per gestire la pressione dei pulsanti (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));

Ascolta gli aggiornamenti di stato

Il componente UI deve aggiungere un Player.Listener per essere informato delle modifiche di stato che richiedono un aggiornamento della UI corrispondente. Per maggiori dettagli, consulta Ascolta gli eventi di riproduzione.

L'aggiornamento della UI può essere oneroso e spesso si verificano più eventi del player contemporaneamente. Per evitare di aggiornare l'interfaccia utente troppo spesso in un breve periodo di tempo, in genere è meglio ascoltare solo onEvents e attivare gli aggiornamenti dell'interfaccia utente da lì:

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

Gestire i comandi disponibili

Un componente UI generico che potrebbe dover funzionare con diverse implementazioni di Player deve controllare i comandi del player disponibili per mostrare o nascondere i pulsanti ed evitare di chiamare metodi non supportati:

Kotlin

nextButton.isEnabled = player.isCommandAvailable(COMMAND_SEEK_TO_NEXT)

Java

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

Otturatore del primo frame e visualizzazione dell'immagine

Quando un componente UI mostra video o immagini, in genere utilizza una visualizzazione otturatore segnaposto finché non è disponibile il primo frame o la prima immagine reale. Inoltre, la riproduzione mista di video e immagini richiede di nascondere e mostrare la visualizzazione delle immagini nei momenti appropriati.

Un pattern comune per gestire questi aggiornamenti è ascoltare Player.Listener.onEvents() per qualsiasi modifica alle tracce selezionate (EVENT_TRACKS_CHANGED) e per quando è stato eseguito il rendering del primo frame video (EVENT_RENDERED_FIRST_FRAME), nonché ImageOutput.onImageAvailable() per quando è disponibile una nuova immagine:

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, 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.
}

Controlli della barra di scorrimento e del cursore di riproduzione

Quando implementi una barra di scorrimento o uno scrubber personalizzati che si connettono a un'istanza ExoPlayer, attiva la modalità di scrubbing con ExoPlayer.setScrubbingModeEnabled quando l'utente inizia a trascinare il cursore dello scrubber, invia gli aggiornamenti di Player.seekTo durante il trascinamento e disattiva la modalità di scrubbing non appena il gesto termina o viene annullato. Evita di lasciare attiva la modalità di scrubbing durante la riproduzione normale o le singole ricerche, perché sopprime la riproduzione e aumenta l'utilizzo delle risorse del decoder.

Ti consigliamo inoltre di configurare una tolleranza di ricerca frazionaria basata su dp dalla larghezza dello scrubber della UI utilizzando ScrubbingModeParameters.Builder.setFractionalSeekTolerance in modo che ExoPlayer possa agganciarsi ai keyframe vicini entro la precisione di tocco dello scrubber. Per esempi di codice e dettagli, consulta Modalità di scrubbing.