Interface do player

Um player é o componente do app que facilita a reprodução de itens de mídia. A interface Player do Media3 define um esboço para a funcionalidade geralmente processada por um player. Isso inclui:

• Afetando os controles de reprodução, como tocar, pausar e procurar
• Consultar propriedades da mídia em reprodução, como a posição de reprodução
• Gerenciar uma playlist/fila de itens de mídia
• Configurar propriedades de reprodução, como embaralhamento, repetição, velocidade e volume.
• Renderizando vídeo na tela

O Media3 também oferece uma implementação da interface Player, chamada ExoPlayer.

Uma interface comum entre componentes

Vários componentes no Media3 implementam a interface do player, por exemplo:

Embora um MediaSession não implemente a interface Player, ele exige um Player ao criar um. O objetivo é fornecer acesso ao Player de outros processos ou threads.

Arquitetura de reprodução do Media3

Se você tiver acesso a um Player, chame os métodos dele diretamente para emitir comandos de reprodução. É possível anunciar a reprodução e conceder o controle de reprodução de fontes externas implementando um MediaSession. Essas fontes externas implementam um MediaController, que facilita a conexão a uma sessão de mídia e a emissão de solicitações de comando de reprodução.

Ao reproduzir mídia em segundo plano, você precisa armazenar a sessão de mídia e o player em um MediaSessionService ou MediaLibraryService que seja executado como um serviço em primeiro plano. Se você fizer isso, poderá separar o player da atividade no app que contém a interface para controle de reprodução. Isso pode exigir que você use um controle de mídia.

Estado do player

O estado de um player de mídia que implementa a interface Player consiste em quatro categorias de informações:

1. Estado da reprodução
   • Recupere com getPlaybackState().
   • O valor do estado definido pela interface é STATE_IDLE, STATE_BUFFERING, STATE_READY e STATE_ENDED.
2. Playlist de itens de mídia
   • Uma sequência de instâncias MediaItem para reprodução.
   • Recuperar com getCurrentTimeline()
   • As instâncias de Player podem fornecer métodos de operação de playlist, como adicionar ou remover um MediaItem e métodos de conveniência, como getCurrentMediaItem().
3. Propriedades de reproduzir/pausar, como:
   • playWhenReady: uma indicação de se o usuário quer que a mídia seja reproduzida quando possível ou se quer que ela fique pausada.
   • Motivo da supressão da reprodução: uma indicação de por que a reprodução foi suprimida, se aplicável, mesmo que playWhenReady seja true.
   • isPlaying: uma indicação de se o player está sendo reproduzido, que será true apenas se o estado de reprodução for STATE_READY, playWhenReady for true e a reprodução não for suprimida.
4. Posição da reprodução, incluindo:
   • Índice atual do item de mídia: o índice do MediaItem atual na playlist.
   • isPlayingAd: uma indicação de se um anúncio inserido está sendo veiculado.
   • Posição de reprodução atual: a posição de reprodução atual no MediaItem atual ou no anúncio inserido.

Além disso, a interface Player permite o acesso às faixas disponíveis, metadados de mídia, velocidade de reprodução, volume e outras propriedades auxiliares da reprodução.

Detectar mudanças

Use um Player.Listener para detectar mudanças em um Player. Consulte a documentação do ExoPlayer sobre Eventos do player para saber como criar e usar um listener.

A interface do listener não inclui callbacks para rastrear a progressão normal da reprodução. Para monitorar continuamente o progresso da reprodução, como configurar uma interface de barra de progresso, consulte a posição atual em intervalos adequados.

val handler = Handler(Looper.getMainLooper())
fun checkPlaybackPosition(delayMs: Long): Boolean =
  handler.postDelayed(
    {
      val currentPosition = player.currentPosition
      // Update UI based on currentPosition
      checkPlaybackPosition(delayMs)
    },
    delayMs)

Handler handler = new Handler(Looper.getMainLooper());
boolean checkPlaybackPosition(long delayMs) {
    return handler.postDelayed(() -> {
        long currentPosition = player.getCurrentPosition();
        // Update UI based on currentPosition
        checkPlaybackPosition(delayMs);
    }, delayMs);
}

Controlar a reprodução

A interface Player oferece várias maneiras de manipular o estado e controlar a reprodução:

• Controles de reprodução básicos, como play(), pause(), prepare() e stop().
• Operações de playlist, como addMediaItem() ou removeMediaItem().
• Procurando para mudar o item ou a posição atual.
• Defina os modos de repetição e o modo de ordem aleatória.
• Atualize as preferências de seleção de faixa.
• Defina a velocidade de reprodução.

Implementações personalizadas de Player

Para criar um player personalizado, estenda o SimpleBasePlayer incluído no Media3. Essa classe oferece uma implementação básica da interface Player para reduzir ao mínimo o número de métodos que você precisa implementar.

Comece substituindo o método getState(). Esse método precisa preencher o estado atual do player quando chamado, incluindo:

• O conjunto de comandos disponíveis
• Propriedades de reprodução, por exemplo, se o player precisa iniciar a reprodução quando o estado de reprodução for STATE_READY, o índice do item de mídia em reprodução no momento e a posição da reprodução no item atual.

class CustomPlayer : SimpleBasePlayer(looper) {
  override fun getState(): State {
    return State.Builder()
      .setAvailableCommands(...) // Set which playback commands the player can handle
      // Configure additional playback properties
      .setPlayWhenReady(true, PLAY_WHEN_READY_CHANGE_REASON_USER_REQUEST)
      .setCurrentMediaItemIndex(0)
      .setContentPositionMs(0)
      .build()
  }
}

public class CustomPlayer extends SimpleBasePlayer {
  public CustomPlayer(Looper looper) {
    super(looper);
  }

  @Override
  protected State getState() {
    return new State.Builder()
      .setAvailableCommands(...) // Set which playback commands the player can handle
      // Configure additional playback properties
      .setPlayWhenReady(true, PLAY_WHEN_READY_CHANGE_REASON_USER_REQUEST)
      .setCurrentMediaItemIndex(0)
      .setContentPositionMs(0)
      .build();
  }
}

SimpleBasePlayer vai exigir que o State seja criado com uma combinação válida de valores de estado. Ele também processará os listeners e os informará sobre mudanças de estado. Se você precisar acionar manualmente uma atualização de estado, chame invalidateState().

Além do método getState(), você só precisa implementar métodos usados para comandos que o jogador declara como disponíveis. Encontre o método de manipulador substituível que corresponde à funcionalidade que você quer implementar. Por exemplo, substitua o método handleSeek() para oferecer suporte a operações como COMMAND_SEEK_IN_CURRENT_MEDIA_ITEM e COMMAND_SEEK_TO_NEXT_MEDIA_ITEM.