Conceitos do gerenciador de pré-carregamento

O gerenciador de pré-carregamento ajuda a oferecer uma experiência melhor aos usuários, veiculando conteúdo mais rápido e com menos espera quando eles mudam de um item para outro. Ele também permite personalizar a duração e a classificação do pré-carregamento por item.

Uma situação comum nas redes sociais é quando um app mostra uma lista ou um carrossel de opções de mídia para o usuário. Por exemplo, um app pode mostrar um carrossel de vídeos curtos. Quando um vídeo termina, o app muda para o próximo. E, se o usuário não gostar do vídeo que está assistindo, ele poderá deslizar para o próximo ou para o anterior.

Se você não pré-carregar o conteúdo de vídeo, isso poderá resultar em uma experiência frustrante para o usuário. O usuário termina de assistir uma mídia e precisa esperar que a próxima seja carregada.

Por outro lado, se você pré-carregar o conteúdo de forma muito agressiva, isso desperdiça energia e largura de banda da rede, carregando conteúdo que o usuário talvez nunca reproduza.

DefaultPreloadManager ajuda seu app a equilibrar essas preocupações. O gerenciador de pré-carregamento funciona com o app para decidir a importância de cada item de mídia e carrega a quantidade apropriada com antecedência.

Divisão do trabalho

Se você usar DefaultPreloadManager, parte do trabalho será feita pelo seu código e parte pelo gerenciador de pré-carregamento.

Seu app precisa fazer o seguinte:

  • Crie os objetos ExoPlayer do app usando o mesmo objeto DefaultPreloadManager.Builder que você usa para criar o gerenciador de pré-carregamento. Chame DefaultPreloadManager.Builder.buildExoPlayer() para criar um ExoPlayer.
  • Informe ao gerenciador de pré-carregamento sobre cada item de mídia que ele precisa rastrear. Esse pode não ser todo o conteúdo do carrossel. Em vez disso, você pode informar apenas os primeiros itens a serem reproduzidos. À medida que o usuário navega pelo carrossel, você pode adicionar e remover itens de mídia do pool do gerenciador de pré-carregamento.
  • Invalide as prioridades no gerenciador de pré-carregamento quando o conteúdo do carrossel mudar ou quando o usuário mudar o item que está reproduzindo. Isso informa ao gerenciador de pré-carregamento para redeterminar a prioridade de cada item de mídia e carregar o conteúdo, se necessário. Você vai invalidar o gerenciador de pré-carregamento depois de adicionar itens de mídia pela primeira vez e também quando o usuário passar de um item para outro ou quando você adicionar ou remover itens do carrossel.
  • Responda às consultas do gerenciador de pré-carregamento, informando quanto conteúdo pré-carregar para cada item.

  • Busque mídia do gerenciador de pré-carregamento quando o usuário começar a reproduzir um item. O gerenciador de pré-carregamento fornece ao app uma MediaSource para esse conteúdo.

  • Libere o gerenciador de pré-carregamento quando terminar de usá-lo, liberando os recursos.

O gerenciador de pré-carregamento faz o seguinte:

  • Ele acompanha todos os itens de mídia que o app adicionou.
  • Cada vez que as prioridades são invalidadas, ele consulta o app chamando um TargetPreloadStatusControl implementado pelo app. Ele chama isso para descobrir quanto de cada item de mídia carregar.
  • Depois de consultar o app, ele pré-carrega a quantidade apropriada de cada item de mídia. O gerenciador de pré-carregamento decide a ordem de carregamento do item. Ele prioriza os itens mais próximos do item que o usuário está reproduzindo.
  • Quando o app solicita conteúdo, o gerenciador de pré-carregamento fornece uma MediaSource com o conteúdo que já foi carregado.

Fluxo de trabalho do gerenciador de pré-carregamento

Esta seção descreve um fluxo de trabalho típico para um app que usa o gerenciador de pré-carregamento. Neste exemplo, vamos supor que o app mostre um carrossel de vídeos curtos. O vídeo selecionado é reproduzido automaticamente, mas o usuário pode rolar o carrossel em qualquer direção, o que interrompe o vídeo que estava sendo reproduzido e inicia o vídeo para o qual ele rola.

Todas essas etapas são discutidas em detalhes nas páginas a seguir.

  1. O app cria um controle de status de pré-carregamento de destino. O gerenciador de pré-carregamento consulta esse controle para descobrir quanto de cada item de mídia carregar.
  2. O app cria um DefaultPreloadManager.Builder e transmite o controle de status de pré-carregamento de destino. Em seguida, o app usa o builder para criar o gerenciador de pré-carregamento.
  3. O app adiciona itens de mídia ao gerenciador de pré-carregamento. O app fornece um índice para cada item, especificando a posição dele no carrossel.
  4. Depois que toda a mídia é adicionada, o app chama invalidate() para informar ao gerenciador de pré-carregamento para definir as prioridades de cada item e pré-carregá-los.
  5. Para cada item de mídia, o gerenciador de pré-carregamento chama o controle de pré-carregamento de destino para consultar quanto do item precisa ser carregado. O controle de pré-carregamento de destino pode dizer para carregar uma determinada duração de conteúdo, apenas buscar os metadados do item ou não buscar nenhum item no momento. Depois que o gerenciador de pré-carregamento recebe essas informações, ele começa a carregar o conteúdo de mídia.
  6. Quando o usuário começa a reproduzir conteúdo, o app chama o gerenciador de pré-carregamento para solicitar um MediaSource para esse item de mídia. O app também chama setCurrentPlayingIndex() para informar ao gerenciador de pré-carregamento qual item de mídia está sendo reproduzido.
  7. Se o usuário passar para um item de mídia diferente, o app vai solicitar esse item do gerenciador de pré-carregamento e também atualizar o índice de reprodução atual. Em seguida, ele chama invalidate() novamente para informar ao gerenciador de pré-carregamento para atualizar as prioridades com base no que está sendo reproduzido.
  8. Se o app adicionar ou remover itens de mídia do carrossel, ele também vai adicionar ou remover esses itens do gerenciador de pré-carregamento e chamar invalidate() quando terminar.
  9. Sempre que as prioridades do gerenciador de pré-carregamento forem invalidadas, ele vai chamar o controle de pré-carregamento de destino mais uma vez para descobrir quanto de cada item carregar.
  10. Quando o app fecha o carrossel, ele libera o gerenciador de pré-carregamento para liberar os recursos.