Playlists

La API de la playlist se define mediante la interfaz de Player, que se implementa en todas las implementaciones de ExoPlayer. Las playlists permiten la reproducción secuencial de varios elementos multimedia. En el siguiente ejemplo, se muestra cómo iniciar la reproducción de una playlist que contiene dos videos:

// Build the media items.
val firstItem = MediaItem.fromUri(firstVideoUri)
val secondItem = MediaItem.fromUri(secondVideoUri)
// Add the media items to be played.
player.addMediaItem(firstItem)
player.addMediaItem(secondItem)
// Prepare the player.
player.prepare()
// Start the playback.
player.play()

// Build the media items.
MediaItem firstItem = MediaItem.fromUri(firstVideoUri);
MediaItem secondItem = MediaItem.fromUri(secondVideoUri);
// Add the media items to be played.
player.addMediaItem(firstItem);
player.addMediaItem(secondItem);
// Prepare the player.
player.prepare();
// Start the playback.
player.play();

Las transiciones entre elementos de una playlist son fluidas. No es obligatorio que tengan el mismo formato (por ejemplo, está bien que una playlist contenga videos H264 y VP9). Incluso pueden ser de diferentes tipos (es decir, no hay problema si una playlist contiene videos, imágenes y transmisiones de solo audio). Puedes usar el mismo MediaItem varias veces en una playlist.

Cómo modificar la playlist

Puedes modificar una playlist de forma dinámica si agregas, mueves, quitas o reemplazas elementos multimedia. Esto se puede hacer antes y durante la reproducción llamando a los métodos de la API de playlist correspondientes:

// Adds a media item at position 1 in the playlist.
player.addMediaItem(/* index= */ 1, MediaItem.fromUri(thirdUri))
// Moves the third media item from position 2 to the start of the playlist.
player.moveMediaItem(/* currentIndex= */ 2, /* newIndex= */ 0)
// Removes the first item from the playlist.
player.removeMediaItem(/* index= */ 0)
// Replace the second item in the playlist.
player.replaceMediaItem(/* index= */ 1, MediaItem.fromUri(newUri))

// Adds a media item at position 1 in the playlist.
player.addMediaItem(/* index= */ 1, MediaItem.fromUri(thirdUri));
// Moves the third media item from position 2 to the start of the playlist.
player.moveMediaItem(/* currentIndex= */ 2, /* newIndex= */ 0);
// Removes the first item from the playlist.
player.removeMediaItem(/* index= */ 0);
// Replace the second item in the playlist.
player.replaceMediaItem(/* index= */ 1, MediaItem.fromUri(newUri));

También se admite reemplazar y borrar toda la playlist:

// Replaces the playlist with a new one.
val newItems: List<MediaItem> = listOf(MediaItem.fromUri(fourthUri), MediaItem.fromUri(fifthUri))
player.setMediaItems(newItems, /* resetPosition= */ true)
// Clears the playlist. If prepared, the player transitions to the ended state.
player.clearMediaItems()

// Replaces the playlist with a new one.
ImmutableList<MediaItem> newItems =
    ImmutableList.of(MediaItem.fromUri(fourthUri), MediaItem.fromUri(fifthUri));
player.setMediaItems(newItems, /* resetPosition= */ true);
// Clears the playlist. If prepared, the player transitions to the ended state.
player.clearMediaItems();

El reproductor controla automáticamente las modificaciones durante la reproducción de la manera correcta:

• Si se mueve el MediaItem que se está reproduciendo, la reproducción no se interrumpe y se reproducirá su nuevo sucesor cuando finalice.
• Si se quita el MediaItem que se está reproduciendo, el reproductor reproducirá automáticamente el primer sucesor restante o pasará al estado finalizado si no existe un sucesor de este tipo.
• Si se reemplaza el MediaItem que se está reproduciendo, la reproducción no se interrumpe si no cambió ninguna de las propiedades del MediaItem relevantes para la reproducción. Por ejemplo, es posible actualizar los campos MediaItem.MediaMetadata en la mayoría de los casos sin afectar la reproducción.

Consultando la playlist

La playlist se puede consultar con Player.getMediaItemCount y Player.getMediaItemAt. Para consultar el elemento multimedia que se está reproduciendo, llama a Player.getCurrentMediaItem. También hay otros métodos útiles, como Player.hasNextMediaItem o Player.getNextMediaItemIndex, para simplificar la navegación por la playlist.

Modos de repetición

El reproductor admite 3 modos de repetición que se pueden configurar en cualquier momento con Player.setRepeatMode:

• Player.REPEAT_MODE_OFF: La playlist no se repite y el reproductor cambiará a Player.STATE_ENDED una vez que se reproduzca el último elemento de la playlist.
• Player.REPEAT_MODE_ONE: El elemento actual se repite en un bucle sin fin. Métodos como Player.seekToNextMediaItem lo ignorarán y buscarán el siguiente elemento de la lista, que se repetirá en un bucle sin fin.
• Player.REPEAT_MODE_ALL: Toda la playlist se repite en un bucle infinito.

Modo aleatorio

El modo aleatorio se puede habilitar o inhabilitar en cualquier momento con Player.setShuffleModeEnabled. Cuando el reproductor esté en modo aleatorio, reproducirá la playlist en un orden aleatorio precalculado. Todos los elementos se reproducirán una vez y el modo aleatorio también se puede combinar con Player.REPEAT_MODE_ALL para repetir el mismo orden aleatorio en un bucle sin fin. Cuando se desactiva el modo aleatorio, la reproducción continúa desde el elemento actual en su posición original en la playlist.

Ten en cuenta que los índices que muestran métodos como Player.getCurrentMediaItemIndex siempre se refieren al orden original sin mezclar. Del mismo modo, Player.seekToNextMediaItem no reproducirá el elemento en player.getCurrentMediaItemIndex() + 1, sino el siguiente según el orden aleatorio. Si insertas elementos nuevos en la playlist o quitas elementos, el orden aleatorio existente no se modificará en la medida de lo posible.

Cómo establecer un orden aleatorio personalizado

De forma predeterminada, el reproductor admite la reproducción aleatoria con DefaultShuffleOrder. Para personalizarlo, proporciona una implementación de orden aleatorio personalizado o configura un orden personalizado en el constructor DefaultShuffleOrder:

// Set a custom shuffle order for the 5 items currently in the playlist:
exoPlayer.setShuffleOrder(DefaultShuffleOrder(intArrayOf(3, 1, 0, 4, 2), randomSeed))
// Enable shuffle mode.
exoPlayer.shuffleModeEnabled = true

// Set a custom shuffle order for the 5 items currently in the playlist:
exoPlayer.setShuffleOrder(new DefaultShuffleOrder(new int[] {3, 1, 0, 4, 2}, randomSeed));
// Enable shuffle mode.
exoPlayer.setShuffleModeEnabled(/* shuffleModeEnabled= */ true);

Cómo identificar los elementos de una playlist

Para identificar los elementos de la playlist, se puede configurar MediaItem.mediaId cuando se compila el elemento:

// Build a media item with a media ID.
val mediaItem = MediaItem.Builder().setUri(uri).setMediaId(mediaId).build()

// Build a media item with a media ID.
MediaItem mediaItem = new MediaItem.Builder().setUri(uri).setMediaId(mediaId).build();

Si una app no define de forma explícita un ID de contenido multimedia para un elemento multimedia, se usa la representación de cadena del URI.

Cómo asociar datos de apps con elementos de playlist

Además de un ID, cada elemento multimedia también se puede configurar con una etiqueta personalizada, que puede ser cualquier objeto proporcionado por la app. Uno de los usos de las etiquetas personalizadas es adjuntar metadatos a cada elemento multimedia:

// Build a media item with a custom tag.
val mediaItem = MediaItem.Builder().setUri(uri).setTag(metadata).build()

// Build a media item with a custom tag.
MediaItem mediaItem = new MediaItem.Builder().setUri(uri).setTag(metadata).build();

Cómo detectar cuándo la reproducción hace la transición a otro elemento multimedia

Cuando la reproducción hace la transición a otro elemento multimedia o comienza a repetir el mismo elemento multimedia, se llama a Listener.onMediaItemTransition(MediaItem, @MediaItemTransitionReason). Esta devolución de llamada recibe el nuevo elemento multimedia, junto con un @MediaItemTransitionReason que indica por qué se produjo la transición. Un caso de uso común para onMediaItemTransition es actualizar la IU de la app para el nuevo elemento multimedia:

override fun onMediaItemTransition(
  mediaItem: MediaItem?,
  @MediaItemTransitionReason reason: Int,
) {
  updateUiForPlayingMediaItem(mediaItem)
}

@Override
public void onMediaItemTransition(
    @Nullable MediaItem mediaItem, @MediaItemTransitionReason int reason) {
  updateUiForPlayingMediaItem(mediaItem);
}

Si los metadatos necesarios para actualizar la IU se adjuntan a cada elemento multimedia con etiquetas personalizadas, una implementación podría verse de la siguiente manera:

override fun onMediaItemTransition(
  mediaItem: MediaItem?,
  @MediaItemTransitionReason reason: Int,
) {
  var metadata: CustomMetadata? = null
  mediaItem?.localConfiguration?.let { localConfiguration ->
    metadata = localConfiguration.tag as? CustomMetadata
  }
  updateUiForPlayingMediaItem(metadata)
}

@Override
public void onMediaItemTransition(
    @Nullable MediaItem mediaItem, @MediaItemTransitionReason int reason) {
  @Nullable CustomMetadata metadata = null;
  if (mediaItem != null && mediaItem.localConfiguration != null) {
    metadata = (CustomMetadata) mediaItem.localConfiguration.tag;
  }
  updateUiForPlayingMediaItem(metadata);
}

Cómo detectar cuándo cambia la playlist

Cuando se agrega, quita o mueve un elemento multimedia, se llama a Listener.onTimelineChanged(Timeline, @TimelineChangeReason) de inmediato con TIMELINE_CHANGE_REASON_PLAYLIST_CHANGED. Se llama a esta devolución de llamada incluso cuando el reproductor aún no está preparado.

override fun onTimelineChanged(timeline: Timeline, @TimelineChangeReason reason: Int) {
  if (reason == Player.TIMELINE_CHANGE_REASON_PLAYLIST_CHANGED) {
    // Update the UI according to the modified playlist (add, move or remove).
    updateUiForPlaylist(timeline)
  }
}

@Override
public void onTimelineChanged(Timeline timeline, @TimelineChangeReason int reason) {
  if (reason == TIMELINE_CHANGE_REASON_PLAYLIST_CHANGED) {
    // Update the UI according to the modified playlist (add, move or remove).
    updateUiForPlaylist(timeline);
  }
}

Cuando esté disponible información como la duración de un elemento multimedia en la playlist, se actualizará Timeline y se llamará a onTimelineChanged con TIMELINE_CHANGE_REASON_SOURCE_UPDATE. Otros motivos por los que se puede actualizar el cronograma son los siguientes:

• Un manifiesto que está disponible después de preparar un elemento multimedia adaptable.
• Un manifiesto que se actualiza periódicamente durante la reproducción de una transmisión en vivo