Плейлисты

API плейлистов определяется интерфейсом Player , который реализован во всех реализациях ExoPlayer . Плейлисты позволяют последовательно воспроизводить несколько медиафайлов. Следующий пример показывает, как начать воспроизведение плейлиста, содержащего два видео:

// 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();

Переходы между элементами в плейлисте происходят плавно. Нет требования, чтобы они были одного формата (например, плейлист может содержать видео как в формате H264, так и в формате VP9). Они могут даже быть разных типов (то есть, плейлист может содержать видео, изображения и только аудиопотоки). Вы можете использовать один и тот же MediaItem несколько раз в одном плейлисте.

Изменение плейлиста

Вы можете динамически изменять плейлист, добавляя, перемещая, удаляя или заменяя медиафайлы. Это можно сделать как до, так и во время воспроизведения, вызывая соответствующие методы API плейлиста:

// 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));

Также поддерживаются замена и очистка всего плейлиста:

// 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();

Плеер автоматически и корректно обрабатывает изменения во время воспроизведения:

• Если текущий воспроизводимый MediaItem перемещается, воспроизведение не прерывается, и после завершения будет воспроизведен следующий за ним файл.
• Если воспроизводимый в данный момент MediaItem будет удален, плеер автоматически воспроизведет первый оставшийся следующий фрагмент или перейдет в завершенное состояние, если такого следующего фрагмента не существует.
• Если воспроизводимый в данный момент MediaItem заменяется, воспроизведение не прерывается, если ни одно из свойств MediaItem , имеющих отношение к воспроизведению, не изменилось. Например, в большинстве случаев можно обновить поля MediaItem.MediaMetadata без влияния на воспроизведение.

Запрос к плейлисту

Запрос к плейлисту можно выполнить с помощью Player.getMediaItemCount и Player.getMediaItemAt . Запрос текущего воспроизводимого медиафайла можно выполнить с помощью метода Player.getCurrentMediaItem . Также существуют другие удобные методы, такие как Player.hasNextMediaItem или Player.getNextMediaItemIndex , которые упрощают навигацию по плейлисту.

режимы повтора

Плеер поддерживает 3 режима повтора, которые можно установить в любое время с помощью Player.setRepeatMode :

• Player.REPEAT_MODE_OFF : Плейлист не повторяется, и плеер перейдет в состояние Player.STATE_ENDED после воспроизведения последнего элемента плейлиста.
• Player.REPEAT_MODE_ONE : Текущий элемент повторяется в бесконечном цикле. Такие методы, как Player.seekToNextMediaItem игнорируют это и переходят к следующему элементу в списке, который затем будет повторяться в бесконечном цикле.
• Player.REPEAT_MODE_ALL : Весь плейлист повторяется в бесконечном цикле.

режим перемешивания

Режим перемешивания можно включить или выключить в любое время с помощью Player.setShuffleModeEnabled . В режиме перемешивания плеер будет воспроизводить плейлист в заранее рассчитанном случайном порядке. Все элементы будут воспроизведены один раз, а режим перемешивания также можно комбинировать с Player.REPEAT_MODE_ALL для повторения того же случайного порядка в бесконечном цикле. Когда режим перемешивания выключен, воспроизведение продолжается с текущего элемента с его исходной позиции в плейлисте.

Обратите внимание, что индексы, возвращаемые такими методами, как Player.getCurrentMediaItemIndex всегда относятся к исходному порядку воспроизведения без перемешивания. Аналогично, Player.seekToNextMediaItem не будет воспроизводить элемент с индексом player.getCurrentMediaItemIndex() + 1 , а следующий элемент в соответствии с порядком перемешивания. Добавление новых элементов в плейлист или удаление элементов позволит сохранить существующий порядок перемешивания неизменным, насколько это возможно.

Настройка пользовательского порядка перемешивания

По умолчанию плеер поддерживает перемешивание, используя DefaultShuffleOrder . Это можно настроить, предоставив собственную реализацию порядка перемешивания или задав пользовательский порядок в конструкторе 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);

Идентификация элементов плейлиста

Для идентификации элементов плейлиста при его создании можно задать параметр MediaItem.mediaId :

// 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();

Если приложение явно не определяет идентификатор медиафайла, используется строковое представление URI.

Связывание данных приложения с элементами плейлиста

Помимо идентификатора, каждый медиафайл может быть также настроен с помощью пользовательского тега, который может представлять собой любой объект, предоставляемый приложением. Один из способов использования пользовательских тегов — добавление метаданных к каждому медиафайлу:

// 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();

Определение момента перехода воспроизведения к другому медиафайлу.

Когда воспроизведение переходит к другому медиафайлу или начинается повторение того же медиафайла, вызывается Listener.onMediaItemTransition(MediaItem, @MediaItemTransitionReason) . Этот коллбэк получает новый медиафайл вместе с аннотацией @MediaItemTransitionReason , указывающей причину перехода. Часто используемый метод onMediaItemTransition используется для обновления пользовательского интерфейса приложения в соответствии с новым медиафайлом:

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

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

Если метаданные, необходимые для обновления пользовательского интерфейса, прикрепляются к каждому медиафайлу с помощью пользовательских тегов, то реализация может выглядеть следующим образом:

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);
}

Определение момента изменения плейлиста

При добавлении, удалении или перемещении медиафайла немедленно вызывается Listener.onTimelineChanged(Timeline, @TimelineChangeReason) с параметром TIMELINE_CHANGE_REASON_PLAYLIST_CHANGED . Этот коллбэк вызывается даже тогда, когда плеер еще не подготовлен.

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);
  }
}

Когда становится доступна такая информация, как продолжительность медиафайла в плейлисте, Timeline обновляется, и вызывается метод onTimelineChanged с TIMELINE_CHANGE_REASON_SOURCE_UPDATE . Другие причины, которые могут вызвать обновление временной шкалы, включают:

• Манифест становится доступным после подготовки адаптивного медиаконтента.
• Манифест, периодически обновляемый во время воспроизведения прямой трансляции.