Crea y configura un DefaultPreloadManager

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

Los administradores de carga previa 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 carga previa prioriza la carga de los elementos según qué tan cerca se encuentre del elemento que el usuario está reproduciendo. De esa manera, si un usuario se desplaza a otro elemento, el nuevo elemento puede comenzar a reproducirse de inmediato.

Existen tres pasos para crear una instancia de DefaultPreloadManager:

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

Crea un control de estado de carga previa de destino

Cuando crees el objeto DefaultPreloadManager.Builder, le pasarás un objeto control de estado de carga previa de destino 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 averiguar cuánto contenido debe cargar. El control de estado puede responder con uno de los siguientes códigos de estado:

• STAGE_SPECIFIED_RANGE_LOADED: El administrador de carga previa debe cargar el contenido desde la posición de inicio especificada y durante la duración especificada (en milisegundos).
• STAGE_TRACKS_SELECTED: El administrador de carga previa debe cargar y procesar la información del segmento de contenido, y seleccionar los segmentos. El administrador de carga previa aún no debería comenzar a cargar el contenido.
• STAGE_SOURCE_PREPARED: El administrador de carga previa debe preparar la fuente de contenido. Por ejemplo, si los metadatos del contenido se encuentran en un archivo de manifiesto independiente, el administrador de carga previa podría recuperar y analizar ese manifiesto.
• null: El administrador de carga previa 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 elemento 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: Devolución PreloadStatus.TRACKS_SELECTED
• Otros elementos multimedia en el rango de n-4 a n+4: Devolver PreloadStatus.SOURCE_PREPARED
• Para todos los demás elementos multimedia, devuelve null.

class MyTargetPreloadStatusControl(
  currentPlayingIndex: Int = C.INDEX_UNSET
): 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.TRACKS_SELECTED
    } else if (abs(index - currentPlayingIndex) <= 4) {
      // return a PreloadStatus that is labelled by STAGE_SOURCE_PREPARED
      return DefaultPreloadManager.PreloadStatus.SOURCE_PREPARED
    }
    return null
  }
}

Puntos clave sobre el código

• Cuando lo crees, pasarás una instancia de MyTargetPreloadStatusControl al compilador del administrador de carga previa.
• currentPlayingIndex contiene el índice del elemento multimedia que se está reproduciendo. La app es la encargada de mantener ese valor actualizado.
• Cuando el administrador de carga previa 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 devolver comparando ese índice con el del elemento seleccionado actualmente.

Crea el administrador de carga previa

Para crear tu administrador de carga previa, necesitas un DefaultPreloadManager.Builder. Ese compilador se configura con el contexto actual y el control del estado de precarga objetivo de la app. El compilador también proporciona métodos setter que puedes usar para establecer los componentes personalizados del administrador de carga previa.

Además de usar el compilador para crear el administrador de carga previa, también lo usarás para crear los objetos ExoPlayer que tu app usa para reproducir el contenido.

Nota: Solo puedes usar un DefaultPreloadManager.Builder para crear un solo DefaultPreloadManager. Si intentas crear un segundo administrador de carga previa con el mismo compilador, se arroja una excepción, incluso si liberaste el primer administrador de carga previa.

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

Puntos clave sobre el código

• MyTargetPreloadStatusControl es la clase que definiste en Crea un control de estado de precarga de destino.
• Usarás el mismo objeto DefaultPreloadManager.Builder para crear los objetos ExoPlayer que reproducirán el contenido administrado por ese administrador de carga previa.