O gerenciador de pré-carregamento ajuda a oferecer uma experiência melhor aos usuários, veiculando conteúdo mais rapidamente, com menos espera ao alternar 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 é um app mostrar 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 passa para o próximo. Se o usuário não gostar do vídeo que está assistindo, ele pode deslizar para o próximo ou para o anterior.
Se você não pré-carregar o conteúdo de vídeo, isso pode resultar em uma experiência frustrante para o usuário. O usuário termina de consumir 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 vai desperdiçar energia e largura de banda de rede carregando conteúdo que o usuário pode nunca reproduzir.
O 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 adequada 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
ExoPlayerdo app usando o mesmo objetoDefaultPreloadManager.Builderusado para criar o gerenciador de pré-carregamento. ChameDefaultPreloadManager.Builder.buildExoPlayer()para criar umExoPlayer. - Informe ao gerenciador de pré-carregamento sobre cada item de mídia que ele precisa rastrear. Talvez esse não seja todo o conteúdo do carrossel. Em vez disso, você pode informar apenas os primeiros itens a serem reproduzidos. Conforme o usuário navega pelo carrossel, é possível adicionar e remover itens de mídia do pool do gerenciador de pré-carregamento.
- Responder às consultas do gerenciador de pré-carregamento, informando ao gerenciador 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
MediaSourcepara esse conteúdo.Informe ao gerenciador de pré-carregamento o índice do item que está sendo reproduzido. Essas informações são usadas pelo gerenciador de pré-carregamento para determinar a proximidade de cada item de mídia do item em reprodução e priorizar dinamicamente o pré-carregamento de acordo. Quando o usuário navegar para 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 monitora todos os itens de mídia que o app adicionou.
- Sempre que as prioridades são atualizadas, ele consulta o app chamando um
TargetPreloadStatusControlimplementado pelo app. Ele faz isso para descobrir quanto de cada item de mídia carregar. - Depois de consultar o app, ele pré-carrega a quantidade adequada de cada item de mídia. O gerenciador de pré-carregamento decide em que ordem carregar o item. Ele prioriza os itens mais próximos do que o usuário está reproduzindo.
- Quando o app solicita conteúdo, o gerenciador de pré-carregamento fornece um
MediaSourcecom 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 rolou.
Todas essas etapas são discutidas em detalhes nas páginas a seguir.
- 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.
- O app cria um
DefaultPreloadManager.Buildere transmite o controle de status de pré-carregamento de destino. Em seguida, o app usa o builder para criar o gerenciador de pré-carregamento. - 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.
- 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, buscar apenas os metadados do item ou não buscar nada desse 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.
- Quando o usuário começa a reproduzir o conteúdo, o app chama o gerenciador de pré-carregamento
para solicitar um
MediaSourcepara esse item de mídia. O app também chamasetCurrentPlayingIndex()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. - Sempre que as prioridades do gerenciador de pré-carregamento são atualizadas, ele chama o controle de pré-carregamento de destino mais uma vez para descobrir quanto de cada item carregar.
- Quando o app fecha o carrossel, ele libera o gerenciador de pré-carregamento para liberar os recursos.