Gerenciar e assistir conteúdo

Nesta página, descrevemos como usar um gerenciador de pré-carregamento para gerenciar conteúdo de vídeo. Ao usar um gerenciador de pré-carregamento, você oferece uma experiência melhor ao usuário. Quando ele muda de um item de mídia para outro, a reprodução começa mais rápido porque o gerenciador já carregou parte do conteúdo.

Nesta página, abordamos os seguintes tópicos:

Adicionar itens de mídia ao gerenciador de pré-carregamento

Você precisa informar ao gerenciador de pré-carregamento sobre cada item de mídia que ele vai rastrear. Por exemplo, se o app tiver um carrossel de vídeos, adicione-os ao gerenciador de pré-carregamento. Dependendo do seu caso de uso, você pode adicionar todos os vídeos ou apenas os que estão perto do vídeo em reprodução. Você também pode adicionar novos itens ao gerenciador de pré-carregamento depois.

Para fazer isso, use um método de adição em lote, como addMediaItems. Outra opção é chamar add (ou addMediaSource) para adicionar itens de mídia individualmente. No entanto, adicionar itens de mídia individualmente não aciona automaticamente o pré-carregamento. Ao usar métodos individuais, chame explicitamente invalidate depois de adicionar itens para informar ao gerenciador de pré-carregamento que atualize as prioridades e inicie o pré-carregamento.

val initialMediaItems = pullMediaItemsFromService(count = 20)
val rankingDataList = initialMediaItems.indices.toList()
preloadManager.addMediaItems(initialMediaItems, rankingDataList)

Pontos principais sobre o código

  • Este snippet mostra como preencher inicialmente o gerenciador de pré-carregamento no modo em lote depois de criá-lo. Você pode chamar addMediaItems para adicionar itens a um gerenciador de pré-carregamento preenchido.
  • Neste snippet, pullMediaItemsFromService() é a lógica do app para buscar a lista de conteúdo a ser reproduzido. O código chama esse método para buscar uma lista de até 20 itens.
  • preloadManager é o DefaultPreloadManager criado em Criar um DefaultPreloadManager.
  • rankingData é um valor usado pelo gerenciador de pré-carregamento para determinar a prioridade de cada item de mídia. Para DefaultPreloadManager, rankingData é um número inteiro que representa a posição do item no carrossel. O gerenciador de pré-carregamento determina a prioridade com base na distância de cada item em relação ao item que está sendo reproduzido no momento.

Buscar e abrir mídia

Quando o usuário avança para um novo item de mídia, é necessário extrair o item do gerenciador de pré-carregamento. Se o gerenciador de pré-carregamento tiver carregado algum conteúdo, ele será reproduzido mais rápido do que se você não tivesse usado o gerenciador. Se o gerenciador de pré-carregamento ainda não tiver carregado o conteúdo desse item, ele será reproduzido normalmente.

Você também precisa atualizar o índice de reprodução atual no gerenciador de pré-carregamento chamando setCurrentPlayingIndex, o que permite que o gerenciador determine as prioridades das futuras operações de pré-carregamento.

// When a media item is about to be displayed on the screen
val mediaSource = preloadManager.getMediaSource(mediaItem)
if (mediaSource != null) {
  player.setMediaSource(mediaSource)
} else {
  // If the mediaSource is null, its mediaItem hasn't been added to the preload
  // manager yet. Send it directly to the player when it's about to play.
  player.setMediaItem(mediaItem)
}
player.prepare()

// When the media item is being displayed at the center of the screen ("in focus")
player.play()
// Update the current playing index to let the preload manager know where the user
// is in the carousel/pagination/list.
preloadManager.setCurrentPlayingIndex(currentIndex)

Pontos principais sobre o código

  • player é o ExoPlayer do Media3 que o app está usando para reproduzir o conteúdo. Você precisa criar esse jogador chamando DefaultPreloadManager.Builder.buildExoPlayer() no mesmo builder usado para criar o gerenciador de pré-carregamento.
  • Quando o usuário muda para um novo item de mídia, o app chama getMediaSource() para receber a origem da mídia do gerenciador de pré-carregamento. Precisa ser um mediaItem que você já adicionou ao gerenciador de pré-carregamento. Não há problema se o gerenciador de pré-carregamento ainda não tiver começado a carregar o conteúdo. Nesse caso, ele retorna um MediaSource sem dados pré-carregados. Por exemplo, isso pode acontecer se o usuário pular muito para frente no carrossel.
  • Depois que o usuário reproduzir o novo item de mídia, chame setCurrentPlayingIndex para informar ao gerenciador de pré-carregamento em que parte do carrossel o novo item está. O gerenciador de pré-carregamento precisa dessas informações para priorizar o carregamento do próximo item.

Remover itens do gerenciador de pré-carregamento

Para manter a eficiência do gerenciador de pré-carregamento, remova os itens que ele não precisa mais rastrear. Você também pode remover itens que ainda estão no carrossel, mas estão muito longe da posição atual do usuário. Por exemplo, você pode decidir que, se um item estiver a mais de 15 itens de distância do que o usuário está assistindo, ele não precisa ser pré-carregado. Nesse caso, você removeria os itens quando eles ficassem muito distantes. Se o usuário voltar a se aproximar dos itens removidos, você sempre poderá adicioná-los novamente.

Se você tiver uma lista de itens de mídia para remover, use removeMediaItems. Como alternativa, chame remove (ou removeMediaSource) para remover itens de mídia individualmente.

preloadManager.removeMediaItems(mediaItemsToRemove)

Pontos principais sobre o código

Libere o gerenciador de pré-carregamento quando terminar de usá-lo

Quando você não precisar mais do gerenciador de pré-carregamento, libere-o para liberar os recursos. Em particular, libere-o quando sua atividade for destruída.

preloadManager.release()

Pontos principais sobre o código

  • Você não pode chamar nenhum dos métodos do objeto depois de liberá-lo.
  • Se você precisar criar outro gerenciador de pré-carregamento, crie um novo DefaultPreloadManager.Builder e use-o para criar o DefaultPreloadManager. Não tente reutilizar o builder antigo.