Выбор качества

Для переключения качества плеер может использовать разные файлы. Варианты качества также могут существовать внутри HLS и DASH манифестов.

Для переключение между файлами нужно передать набор ссылок параметром file

[Низкое]ссылка1,[Среднее]ссылка2,[Высокое]ссылка3

Например

new Playerjs({
  "id":"player",
  "file":"[480p]//site.com/video480.mp4,[720p]//site.com/video720.mp4"
});

Первым в данном случае будет загружаться качество 480p. Можно передать названия вариантов качества отдельно параметром qualities

"file":"//site.com/video480.mp4,//site.com/video720.mp4",
"qualities":"480p,720p"

HLS, DASH и YouTube

Технологии HLS и DASH так устроены, что могут содержать внутри одного манифеста (m3u8 или mpd) различные варианты качества и аудиодорожек. По умолчанию плеер использует этот вариант и берет все эти данные из манифеста (кроме iOS, где воспроизведение HLS работает нативно и плеер вообще не видит варианты качества внутри манифеста).

Варианты качества плеер называет исходя из настроек. По умолчанию, используется приближенное разрешение видео (например, 480p, 720p, 1080p). Если окажутся два одинаковых названия, плеер автоматически добавит битрейт (например, 1000kbps) - можно выбрать этот вариант отдельно. Также в настройках можно выбрать эпитет (низкое, высокое, HD и т.д.).

Если вы хотите переключаться между разными манифестами, как это работает для файлов, то в PRO версии есть опция HLS (DASH) / Выбор качества (аудио) из манифеста, которую нужно отключить.

file:"[Низкое]//site.com/low.m3u8,[Высокое]//site.com/high.m3u8"

Качество по умолчанию

Параметром default_quality можно включить нужное качество, указав его название.

new Playerjs({
  "id":"player",
  "file":"[480p]//site.com/video480.mp4,[720p]//site.com/video720.mp4",
  "default_quality":"720p"
});

new Playerjs({
  "id":"player",
  "file":"//site.com/video.m3u8",
  "default_quality":"Низкое"
});

C версии 10 также можно указывать номер варианта качества по-умолчанию в формате num:X, если есть варианты с одинаковыми названиями. Нумерация начинается с нуля и включает в себя также разделители групп:

"default_quality":"num:2"

Вы также можете указать максимальное значение качества (последнее по списку) по умолчанию с версии 12.4:

"default_quality":"max"

Если у вас включено запоминание качества, то оно имеет приоритет и параметр default_quality работать не будет.

Разделители групп

Вы можете использовать в списке вариантов качества неактивные элементы, чтобы разделить варианты по группам. Такой разделитель нужно обозначить тремя знаками <<< в начале названия. Это работает с версии 9.75

"file":"[480p]ссылка,[720p]ссылка,[<<<Первая группа],[480p]ссылка,[720p]ссылка,[<<<Вторая группа]"

В названиях также можно использовать HTML форматирование:

[<<<<div style='border-bottom:1px solid #fff;'>Первая группа</div>]

Как скрыть часть вариантов качества

Параметром forbidden_quality можно запретить определенные варианты качества, указав их названия через запятую. Запрещенные варианты не будут отображаться в меню, но могут быть доступны для адаптивного режима Авто HLS или DASH (проблема решается выключением запоминания качества, добавлением Авто в список ограничений и указанием доступного варианта качества параметром default_quality)

new Playerjs({
  "id":"player",
  "file":"[480p]//site.com/video.m3u8",
  "forbidden_quality":"720p,1080p,Авто",
  "default_quality":"480p"
});

---