Conceitos do gerenciador de pré-carregamento

O gerenciador de pré-carregamento ajuda a oferecer uma experiência melhor aos usuários, mostrando 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 mídias 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 o 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.

O 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 apenas informar 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.
• 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 um MediaSource para esse conteúdo.

• Informe ao gerenciador de pré-carregamento o índice do item em reprodução. Essas informações são usadas pelo gerenciador de pré-carregamento para determinar a proximidade de cada item de mídia ao item em reprodução e priorizar dinamicamente o pré-carregamento de acordo. Quando o usuário navegar até um novo item, atualize esse índice com o gerenciador de pré-carregamento.

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

O gerenciador de pré-carregamento faz o seguinte:

• Ele acompanha todos os itens de mídia que o app adicionou a ele.
• Cada vez que as prioridades são atualizadas, 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 um 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. 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.
5. 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, para que as prioridades dos itens de mídia sejam atualizadas.
6. Sempre que as prioridades do gerenciador de pré-carregamento são atualizadas, ele chama o controle de pré-carregamento de destino novamente para descobrir quanto de cada item carregar.
7. Quando o app fecha o carrossel, ele libera o gerenciador de pré-carregamento para liberar os recursos dele.