Crea y configura un DefaultPreloadManager

En esta página, se describe cómo crear un DefaultPreloadManager, que precarga contenido multimedia para tu app según la estrategia que elijas.

Los administradores de precarga basados en la clase abstracta BasePreloadManager te permiten clasificar el contenido según los criterios que elijas. En este documento, se explica cómo usar la clase derivada DefaultPreloadManager, en la que cada elemento multimedia se clasifica con un número entero que representa su ubicación en una lista (por ejemplo, su posición en un carrusel de videos). El administrador de precarga prioriza la carga de los elementos según la cercanía con el elemento que el usuario está reproduciendo. De esa manera, si un usuario pasa a otro elemento, el nuevo puede comenzar a reproducirse de inmediato.

Para crear una instancia de DefaultPreloadManager, sigue estos tres pasos:

  • Define un TargetPreloadStatusControl que el administrador de precarga pueda consultar para saber si el elemento multimedia está listo para cargarse y cuánto cargar.
  • Crea el compilador que usarás para crear el administrador de precarga y los objetos ExoPlayer de tu app.
  • Usa el compilador para crear el administrador de precarga llamando al método build() del compilador.

Crea un control de estado de precarga de destino

Cuando crees el DefaultPreloadManager.Builder, le pasarás un objeto de control de estado de precarga objetivo que definas. Este objeto implementa la interfaz TargetPreloadStatusControl. Cuando el administrador de precarga se prepara para precargar contenido multimedia, llama al método getTargetPreloadStatus() de tu control de estado para determinar si se debe preparar, cargar o almacenar en caché el contenido de un elemento multimedia. La carga precarga los datos multimedia directamente en el búfer en memoria de un reproductor, lo que los prepara para la reproducción instantánea, mientras que el almacenamiento en caché guarda los datos multimedia en una memoria caché de disco persistente para ahorrar memoria del reproductor. El control de estado puede responder con uno de estos códigos de estado:

  • STAGE_SPECIFIED_RANGE_LOADED: El administrador de precarga debe cargar el contenido desde la posición de inicio especificada y durante el tiempo especificado (en milisegundos) en el búfer en memoria del reproductor.
  • STAGE_SPECIFIED_RANGE_CACHED: El administrador de precarga debe almacenar en caché el contenido desde la posición de inicio especificada y durante el tiempo especificado (en milisegundos) en la memoria caché del disco.
  • STAGE_TRACKS_SELECTED: El administrador de precarga debe cargar y procesar la información de la pista de contenido, y seleccionar las pistas. El administrador de precarga aún no debería comenzar a cargar el contenido.
  • STAGE_SOURCE_PREPARED: El administrador de precarga debe preparar la fuente del contenido. Por ejemplo, si los metadatos del contenido se encuentran en un archivo de manifiesto independiente, el administrador de precarga podría recuperar y analizar ese manifiesto.
  • null: El administrador de precarga no debe cargar ningún contenido ni metadatos para ese elemento multimedia.

Deberás tener una estrategia para decidir cuánto contenido cargar para cada elemento multimedia. En este ejemplo, se carga más contenido para los elementos más cercanos al que se está reproduciendo. Si el usuario reproduce contenido con el índice n, el controlador devuelve los siguientes códigos:

  • Índice n+1 (el siguiente elemento multimedia): Carga 3,000 ms (3 segundos) desde la posición de inicio predeterminada.
  • Índice n-1 (el elemento multimedia anterior): Carga 1,000 ms (1 segundo) desde la posición de inicio predeterminada.
  • Otros elementos multimedia en el rango de n-2 a n+2: Retorno PreloadStatus.TRACKS_SELECTED
  • Otros elementos multimedia en el rango de n-4 a n+4: Retorno PreloadStatus.SOURCE_PREPARED
  • Para todos los demás elementos multimedia, devuelve null.

class MyTargetPreloadStatusControl(var currentPlayingIndex: Int = 0) :
  TargetPreloadStatusControl<Int, DefaultPreloadManager.PreloadStatus> {

  override fun getTargetPreloadStatus(index: Int): DefaultPreloadManager.PreloadStatus {
    if (index - currentPlayingIndex == 1) { // next track
      // return a PreloadStatus that is labelled by STAGE_SPECIFIED_RANGE_LOADED and
      // suggest loading 3000ms from the default start position
      return DefaultPreloadManager.PreloadStatus.specifiedRangeLoaded(3000L)
    } else if (index - currentPlayingIndex == -1) { // previous track
      // return a PreloadStatus that is labelled by STAGE_SPECIFIED_RANGE_LOADED and
      // suggest loading 3000ms from the default start position
      return DefaultPreloadManager.PreloadStatus.specifiedRangeLoaded(3000L)
    } else if (abs(index - currentPlayingIndex) == 2) {
      // return a PreloadStatus that is labelled by STAGE_TRACKS_SELECTED
      return DefaultPreloadManager.PreloadStatus.PRELOAD_STATUS_TRACKS_SELECTED
    } else if (abs(index - currentPlayingIndex) <= 4) {
      // return a PreloadStatus that is labelled by STAGE_SOURCE_PREPARED
      return DefaultPreloadManager.PreloadStatus.PRELOAD_STATUS_SOURCE_PREPARED
    }
    return DefaultPreloadManager.PreloadStatus.PRELOAD_STATUS_NOT_PRELOADED
  }
}

Puntos clave sobre el código

  • Pasarás una instancia de MyTargetPreloadStatusControl al compilador del administrador de precarga cuando lo crees.
  • currentPlayingIndex contiene el índice del elemento multimedia que se está reproduciendo. La app se encarga de mantener ese valor actualizado.
  • Cuando el administrador de precarga está listo para cargar contenido, llama a getTargetPreloadStatus y pasa la información de clasificación que especificaste para ese elemento multimedia correspondiente. En el caso de DefaultPreloadManager, esa información de clasificación es un número entero que especifica la posición del elemento en un carrusel. El método elige qué código mostrar comparando ese índice con el índice del elemento que está seleccionado actualmente.

Crea el administrador de precarga

Para crear tu administrador de precarga, necesitas un DefaultPreloadManager.Builder. Ese compilador se configura con el contexto actual y el control de estado de precarga de destino de la app. Puedes crear un administrador de precarga con todos los parámetros de configuración predeterminados.

val targetPreloadStatusControl = MyTargetPreloadStatusControl()
val preloadManagerBuilder = DefaultPreloadManager.Builder(context, targetPreloadStatusControl)
val preloadManager = preloadManagerBuilder.build()

El compilador también proporciona métodos set que puedes usar para establecer los componentes personalizados del administrador de precarga.

Por ejemplo, puedes personalizar el total de bytes de búfer objetivo para todas las fuentes de medios de carga previa en DefaultPreloadManager, de modo que los datos cargados previamente no superen ese límite. Puedes configurar ese límite con setPlayerTargetBufferBytes(String, int) en un DefaultLoadControl.Builder personalizado con el nombre del reproductor "preload" y pasar esa instancia al compilador del administrador de precarga:

val targetPreloadStatusControl = MyTargetPreloadStatusControl()
val preloadManagerBuilder = DefaultPreloadManager.Builder(context, targetPreloadStatusControl)

preloadManagerBuilder.setLoadControl(
  DefaultLoadControl.Builder()
    .setPlayerTargetBufferBytes("preload", 128 * 1024 * 1024) // 128 MiB
    .build()
)
val preloadManager = preloadManagerBuilder.build()

Si bien los métodos set del compilador son básicamente opcionales para la personalización, si quieres almacenar en caché cualquier elemento multimedia en el disco, debes configurar el compilador con un Cache llamando a setCache(). Si no se configura ninguna caché, intentar almacenar en caché los elementos multimedia generará un IllegalStateException.

Crea el ExoPlayer para reproducir el elemento multimedia precargado

Además de usar el compilador para crear el administrador de precarga, también lo usarás para crear los objetos ExoPlayer que usa tu app para reproducir el contenido, de modo que el ExoPlayer comparta correctamente los componentes con el administrador de precarga. Aún puedes establecer las configuraciones específicas de reproducción para ExoPlayer pasando una instancia de ExoPlayer.Builder con esas configuraciones establecidas.

// Direct creation
val exoPlayer = preloadManagerBuilder.buildExoPlayer()

// Creation with custom playback specific configurations
val skipSilenceExoPlayerBuilder = ExoPlayer.Builder(context).setSkipSilenceEnabled(true)
val skipSilenceExoPlayer = preloadManagerBuilder.buildExoPlayer(skipSilenceExoPlayerBuilder)