Руководство по интеграции плеера

Онлайн-плеер

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

Используйте #url= для ссылок воспроизведения. URL видео и все параметры указываются после #.

Создать ссылку для воспроизведения

URL
https://m3u8-player.com/ru/#url=https://example.com/video.m3u8
JavaScript
const videoUrl = 'https://example.com/video.m3u8';
const params = new URLSearchParams({
  url: videoUrl, autoplay: '1', muted: '1'
});
const playerUrl = 'https://m3u8-player.com/ru/#' + params;
window.open(playerUrl, '_blank', 'noopener');

Закодируйте полный URL видео один раз как значение url. Разделяйте параметры символом &. Для создания ссылки используйте encodeURIComponent или URLSearchParams.

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

ПараметрЗначенияПо умолчаниюОписание
urlHTTPS URLОбязательноАдрес видео
title≤ 120autoНазвание видео
typeauto / hls / videoautoФормат
autoplay0 / 11Автовоспроизведение
muted0 / 10Заглушить
volume0–1Локальная настройкаГромкость
rate0.25–4Локальная настройкаСкорость воспроизведения
start90 / 01:30 / 00:01:30Сохранённая позицияНачальная позиция (запись)
loop0 / 1Локальная настройкаПовтор
posterHTTPS URL—Обложка
subtitleHTTPS SRT / VTT URL—Субтитры
langar / de / en / es / fr / hi / id / it / ja / ko / pt / ru / th / tr / vi / zh-CN / zh-TWautoСменить язык
history0 / 1Локальная настройкаИстория
resume0 / 11Сохранённая позиция
theater0 / 10Режим кино
lights0 / 10Выключить свет
qualityauto / 720 / 1080 / …autoКачество
audio0 / 1 / …autoАудио
aspectauto / 16:9 / 4:3 / 1:1autoСоотношение сторон

Примечания по использованию

  • autoplay=0 загружает плеер на паузе. muted=1 помогает автозапуску, но браузер всё равно может потребовать нажатие. Полный экран и картинка в картинке требуют действия пользователя.
  • Параметры действуют только для этого воспроизведения. Пропущенные значения берутся из локальных настроек. history=0 отключает запись; history=1 учитывает локальный переключатель истории. start важнее сохранённой позиции; resume=0 отключает продолжение.
  • Качество и звуковые дорожки зависят от источника видео и браузера. start применяется к видео по запросу; нумерация дорожек audio начинается с 0.
  • Внешние субтитры поддерживают файлы SRT и VTT в UTF-8 размером до 5 MiB. URL субтитров должен разрешать междоменный доступ.