Плейлисты

Плейлист — это список файлов для воспроизведения (например, коллекция серий), передается плееру параметром file

var player = new Playerjs({
   id:"player",
   file:[
      {"title":"Название","file":"Ссылка"},
      {"title":"Название","file":"Ссылка"}
   ]
});

Можно подключить плейлист ссылкой на документ (важно, чтобы расширение файла было .txt и учитывались кроссдоменные ограничения). С версии 9.50 можно указывать резервные ссылки для плейлистов pl.txt or pl2.txt

Если передавать с расширением txt не получается, попробуйте подключить плейлист параметром pl

var player = new Playerjs({id:"player",file:"http://site.com/playlist.txt"});

Формат

Плейлист указывается в формате JSON. Он заключен в квадратные скобки, внутри передается коллекция записей с параметрами:

title название*
file ссылка на файл*
poster заставка
subtitle субтитры
folder папка
id идентификатор для поиска файла

* обязательные параметры

Если плеер показывает ошибку JSON, значит формат документа неправильный. В таких случаях можно использовать любой онлайн валидатор (json validator) для исправления.

Папки

Плейлист может содержать вложенные плейлисты (папки)

[
   {"title":"Название файла","file":"Cсылка на файл"},
   {"title":"Название папки","folder":
      [
      {"title":"Название файла","file":"Cсылка на файл"},
      {"title":"Название файла","file":"Cсылка на файл"}
      ]
   }
]

По умолчанию в плейлисте открывается первый файл. Если он размещен в папке, то она тоже автоматически откроется. Чтобы избежать этого, включите опцию Модули / Плейлист / Открывать плейлист на верхнем уровне

Редактор плейлистов

Мы сделали специальный редактор для быстрого создания плейлистов с помощью интерфейса.

Результат можно скачать в виде txt файла, скопировать в JSON, а также применить в конструкторе Настройки / Файл / Мои плейлисты

Вы также можете использовать php-скрипт для генерации плейлистов из структуры файлов.

Поиск по id

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

[
   {"title":"Серия1","file":"Cсылка на файл","id":"s1"},
   {"title":"Серия2","file":"Cсылка на файл","id":"s2"},
]

var player = new Playerjs({id:"player",file:"playlist.txt",plstart:"s2"});

В этом примере после запуска плеера начнет воспроизводиться вторая серия.

Оформление

Дизайн плейлистов можно настроить в редакторе в разделе Модули / Плейлист

Чтобы плейлист отобразился в редакторе, нужно указать его плееру в Настройки / Файл или нажать там на надпись плейлист для примера.

Можно обратиться к плейлисту через DOM (для CSS или, например, можно переместить плейлист в наружный контейнер). Если у плеера идентификатор player123, то у плейлиста будет id player123_playlist.

Запоминание

Как запоминать воспроизведенные файлы в плейлисте

Переключение

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

Автоматическое переключение треков плейлиста включается в настройках Модули / ПлейлистАвтоматически запускать следующий файл

Время запуска

Вы можете указать секунду старта параметром start

{"title":"1","file":"ссылка","start":10}

Вы также можете стартовать с текущей секунды при переключении с другого файла, указав значение "start":"continue" (актуально для переключения аудио версий в плейлистах). Также можно использовать другие переменные, ограничивающее время.

Переадресация

Вы можете включить опцию Модули / Переадресация / Переадресация в плейлисте и использовать параметр redirect

[{"title":"1", "file":"video1.mp4", "redirect":"site1.com"},{"title":"2", "file":"video2.mp4", "redirect":"site2.com"}]

В этом случае переход по указанной ссылке произойдет после клика по данной позиции в плейлисте.

Поддержка m3u

Плеер с версии 9.21 поддерживает воспроизведение плейлистов с расширением m3u, если ссылки в нем являются абсолютными (начинаются с https), а также учтены кроссдоменные ограничения.

---