Переключение аудиодорожек

Плеер поддерживает три варианта работы с аудиодорожками:

1. Внутри HLS и DASH (переключается только аудио)
   
2. Заменой источника (переключается аудио вместе с видео)
   
3. Нативно внутри контейнера MP4

Аудиодорожки HLS и DASH

Список аудиодорожек для HLS и DASH формируется автоматически, если в манифесте есть выбор аудио — плеер выведет названия треков в меню настроек. Этот вариант удобнее, но в некоторых случаях возможна рассинхронизация звука и изображения.

Переключение любых источников

Список источников передается плееру параметром file, названия заключены в фигурные скобки, а варианты разделены символом ;

{название дорожки}ссылка1;{название дорожки}ссылка2;{название дорожки}ссылка3

Например

new Playerjs({
  "id":"player",
  "file":"{Русский}//site.com/video_ru.mp4;{Английский}//site.com/video_en.mp4"
});

Если нужно указать варианты качества и аудиодорожек вместе, то качество должно быть снаружи

new Playerjs({
  "id":"player",
  "file":"[480p]{Русский}//site.com/video480_ru.mp4;{Английский}//site.com/video480_en.mp4,[720p]{Русский}//site.com/video720_ru.mp4;{Английский}//site.com/video720_en.mp4"
});

Нативные аудиодорожки внутри MP4

Плеер с версии 18.11 автоматически отображает нативные аудиодорожки, которые встроены в MP4 видео контейнер и поддерживаются некоторыми браузерами (на 2023 год поддержка по-умолчанию есть только в Safari). В Chrome поддержку можно включить в настройках chrome://flags (включите Experimental Web Platform features).

Плеер покажет выбор аудио дорожек, используя информацию из метаданных (у каждой аудиодорожки там есть параметр label и language). Если вы хотите переименовать названия аудиодорожек, используйте параметр rename_audio (ниже указан пример переименования двух аудиодорожек с названиями Track (ru) и Track (en).

let player = new Playerjs({id:"player", file:"//site.com/video.mp4", rename_audio:{"Track (ru)":"Русский","Track (en)":"English"});

Если вы хотите отключить поддержку нативных аудиодорожек, отключите опцию в настройках плеера Звук / Нативные аудиодорожки

Аудиодорожка по умолчанию

Параметром default_audio можно включить нужную аудиодорожку, указав её название.

var player = new Playerjs({
  "id":"player",
  "file":"//site.com/video.m3u8",
  "default_audio":"Английский"
});

Запоминание выбора

В PRO можно включить в настройках Запоминание / Запоминать выбранную аудиодорожку - в этом случае значение выбранной аудиодорожки будет запоминаться на текущем домене, если в плеере есть аудиодорожка с таким названием.

Переименование

Вы можете переименовать аудио дорожки HLS или DASH параметром rename_audio, если в этом есть необходимость (работает с версии 13.15).

rename_audio:{"rus1":"Русский","track2":"Японский"}

С версии 17.8 можно использовать порядковый номер дорожки, начиная с 0

rename_audio:{0:"Русский", 1:"Японский", 2:"Венгерский"}

Переключение в плейлистах

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

---