Формат URL для доступа по HLS

Описание форматов URL для доступа к потокам HLS: прямой эфир, просмотр со сдвигом по времени (DVR) и контент по запросу (VOD).

Все URL указываются относительно сервера OTT: http://<server-address>:<ott-port>. Порт OTT задаётся в мастере настройки и может быть изменён в Settings → HTTP Servers.

1. Структура URL

Базовый путь: /<channel_name> (например, /discovery)
Путь варианта (мультибитрейт): /<channel_name>/<variant> (например, /discovery/1080p)
Имена файлов (по умолчанию, настраиваются в HLS Access):
- index.m3u8: основная точка доступа как для прямого эфира, так и для контента по запросу
  - Без параметров: транслирует прямой эфир
  - С параметром start: предоставляет контент со сдвигом по времени
- media.m3u8 – непосредственный доступ к прямому эфиру без создания сессии
- vod.m3u8 – прямой доступ к контенту по запросу без создания сессии; URL содержит параметры start и duration

2. Индексный плейлист (режим потока)

URL:

  /<channel_name>/index.m3u8

или с необязательными параметрами:

/<channel_name>/index.m3u8?start=<time>&duration=<sec>

start (необязательный):
- Относительное значение: количество секунд до текущего момента (например, -300)
- Абсолютное значение: метка времени Unix (например, 1747485787)
duration (необязательный): длительность воспроизведения в секундах

Примеры:

# 5 minutes ago to now
/discovery/index.m3u8?start=-300

# 40-second segment from a timestamp
/discovery/index.m3u8?start=1747485787&duration=40

2.1. Индексный плейлист со встроенной меткой времени (поведение, аналогичное Flussonic)

Альтернативный синтаксис, при котором параметры встраиваются в имя файла, а не передаются в строке запроса. Для совместимости с поведением, аналогичным Flussonic, поддерживаются оба префикса: index- и archive-.

URL:

/<channel_name>/index-<timestamp>-<duration>.m3u8

или

/<channel_name>/archive-<timestamp>-<duration>.m3u8

timestamp: метка времени Unix (например, 1747485787)
duration: длительность воспроизведения в секундах (используйте now для неограниченного воспроизведения/прямого эфира)

Примеры:

# 15-minute segment from specific timestamp
/discovery/index-1747485787-900.m3u8

# Live stream from specific timestamp (increased constantly)
/discovery/index-1747485787-now.m3u8

# Same using `archive-` prefix
/discovery/archive-1747485787-900.m3u8

3. Медиаплейлист (прямой эфир)

URL:

/<channel_name>/<variant>/media.m3u8

Транслирует текущие сегменты прямого эфира
Без параметров запроса
Для воспроизведения с мультибитрейтом используйте путь варианта

4. Плейлист VOD (по запросу)

URL:

/<channel_name>/<variant>/vod.m3u8?start=<time>&duration=<sec>

start: относительное или абсолютное значение
duration: обязательный параметр

Примеры:

# 30s clip from 100s ago for SD variant
/discovery/sd/vod.m3u8?start=-100&duration=30

# 30s clip from timestamp using variant
/discovery/hd/vod.m3u8?start=1747485787&duration=30

5. Параметры запроса

Параметр	Тип	Описание
`start`	относительное/абсолютное	Время начала воспроизведения (смещение или время Unix)
`duration`	секунды	Длительность воспроизведения

6. Коды ответа

Код	Описание
`400`	Недопустимый URL или параметры. Например, `vod.m3u8` без `start` и `duration`
`403`	Доступ запрещён авторизацией
`404`	Канал не найден или не запущен
`410`	Медиаданные ещё не готовы
`425`	Плейлист ещё не готов. Подождите несколько секунд после запуска или перезапуска канала

7. Примечания по воспроизведению

Доступ: по умолчанию публичный. При необходимости включите аутентификацию.
Пауза/перемотка:
- Index: ограниченная перемотка назад
- VOD: полная перемотка в пределах запрошенного диапазона
Мультибитрейт:
- index.m3u8 перечисляет доступные варианты
- URL media.m3u8 и vod.m3u8 с именем варианта принудительно выбирают конкретный вариант. index.m3u8 доступен только без указания варианта
Архив: для доступа к VOD или индексу со сдвигом по времени необходимо включить архив (Хранилище должно быть назначено в настройках канала)