Skip to content

Совместимость с Flussonic

Sapsan отвечает на привычные URL-ы Flussonic Media Server, чтобы существующие плееры, интеграции и мониторинг продолжали работать при миграции. Совместимость включена по умолчанию и выключается в конфиге:

flussonic:
  streaming: false   # по умолчанию true

Поддерживаемые легаси-URL

Распознаются следующие формы адресов (GET/HEAD; OPTIONS обслуживает CORS preflight):

Legacy URL Назначение
/<stream>/index.m3u8 HLS; раскладка зависит от профиля
/<stream>/index.fmp4.m3u8, /<stream>/index.ll.m3u8 302 на нативный мастер HLS
/<stream>/tracks-<tracks>/index.m3u8 (также index.fmp4.m3u8, index.ll.m3u8) HLS с выбором дорожек
/<stream>/variant/<track>/index.m3u8 Плейлист дорожки
/<stream>/rewind-<seconds>.m3u8 HLS с отмоткой; раскладка зависит от профиля
/<stream>/video.m3u8 Мастер HLS с мультиплексированным MPEG-TS
/<stream>/video-<from>-<duration>.m3u8 Архивный HLS с мультиплексированным MPEG-TS
/<stream>/video-rewind-<seconds>.m3u8 Legacy-форма; живой смешанный мастер без отмотки
/<stream>/index-<from>-<duration>.m3u8, /<stream>/archive-<from>-<duration>.m3u8 (также .fmp4.m3u8) Архивный HLS
/<stream>/tracks-<tracks>/index-<from>-<duration>.m3u8 (также archive-, .fmp4.m3u8) Архивный HLS с выбором дорожек
/<stream>/archive-<from>-<duration>.mpd 302 на архивный DASH
/<stream>/archive-<from>-<duration>.mp4 302 на выгрузку архива
/<stream>/tracks-<tracks>/archive-<from>-<duration>.mp4 Выгрузка архива с выбором дорожек
/<stream>/info.json, /<stream>/ranges.json, /<stream>/recording_status.json Информация о стриме, диапазоны архива, состояние записи
/<stream>/preview.jpg, /<stream>/preview.mp4 Live-превью
/<stream>/<utc>-preview.jpg, /<stream>/<utc>-preview.mp4, /<stream>/<utc>.jpg, /<stream>/YYYY/MM/DD/HH/MM/SS-preview.jpg, /<stream>/YYYY/MM/DD/HH/MM/SS-preview.mp4 Превью архива
/<stream>/m4f, /<stream>/m4s Legacy-транспорт live
/<stream>/archive-<from>-<duration>[.m4f], /<stream>/m4f-<from>-<duration>[.m4f] Legacy-лента архива; длительность также принимает now
/<stream>/YYYY/MM/DD/HH/MM/SS.m4f, /<stream>/YYYY/MM/DD/HH/MM/SS.jpg Legacy-сегмент архива или превью
/<stream>.isml/manifest, /<stream>.isml/Manifest 307 на нативный манифест MSS
/<stream>(archive=<from>-<duration>).isml/manifest (также Manifest) Манифест архива MSS
/<stream>.isml/QualityLevels(<bitrate>)/Fragments(<track>=<time>) (также архивная форма .isml) Фрагмент MSS

В формах m4f [.m4f] означает необязательное расширение. Метка <utc> для превью может быть в секундах или миллисекундах Unix.

<from> и <duration> — целые секунды, длительность окна положительная. <tracks> — номера вида v1a1. Вложенные info.json и ranges.json также распознаются. Старые селекторы mono, video, video<N>, track-* и txt-* перед окном архива принимаются без такого выбора дорожек: возвращается полный мастер.

Нейтральные HLS URL (index.m3u8, архивные .m3u8, rewind-…) с профилем выдачи, содержащим hls, возвращают мастер в заданной профилем раскладке. Без такого профиля они перенаправляют на нативный fMP4 HLS. Явные .fmp4.m3u8 и .ll.m3u8 сохраняют fMP4-выдачу. Семейство video* выдаёт мультиплексированный MPEG-TS.

Распознавание URL не означает поддержку всех режимов: выгрузка .ts и длительность now для выгрузки возвращают 422; rewind для .isml не поддерживается. Конечные адреса используют ту же авторизацию, ограничения лицензии и наличие архива, что и нативные URL.

Параметры ranges.json: closed_at_gte, opened_at_gte, opened_at_lte, resolution, limit, cursor, sort.

Формы video<N>.m3u8 и их архивные/rewind-варианты не поддерживаются.

Форма плейлиста на адресах Flussonic

Нейтральные адреса index.m3u8, архивные окна .m3u8 и rewind-<seconds>.m3u8 под профилем устройства с секцией hls возвращают плейлист с кодом 200. Профиль без секции hls или отсутствие профиля сохраняет редирект 302 на нативный fMP4-адрес с исходным query. Архивное окно сохраняет границы времени, а legacy rewind под таким профилем выдаёт живой мастер без отмотки; from в query может выбрать архив.

Поле hls.output выбранного по запросу профиля задаёт форму:

  • fmp4 — фрагменты fMP4.
  • ts — MPEG-TS с отдельными аудиодорожками, путь /streaming/v/<stream>/ts/….
  • ts_mux — MPEG-TS со звуком внутри видеосегмента, путь /streaming/v/<stream>/ts/mux/….

video.m3u8 всегда возвращает смешанную форму ts_mux, даже без профиля; профиль отбирает дорожки. video-rewind-<seconds>.m3u8 распознаётся, но тоже возвращает живой мастер без отмотки. Явные .fmp4.m3u8 и index.ll.m3u8, а также формы с tracks-…/ сохраняют редирект.

Допуск, сессии, запуск ondemand и выбор профиля совпадают с нативной выдачей. Ссылки внутри плейлиста — абсолютные пути под /streaming/v/<stream>/… с параметрами запроса, включая токен. Прокси должен сохранять этот префикс. Самостоятельные семейства mono и timeshift (video-timeshift_rel-…) не поддерживаются. Нативные формы и ограничения кодеков: HLS поверх MPEG-TS.

Admin API v3

API по префиксу /streamer/api/v3 отдает ответы в формате Flussonic Streamer API v3 — см. Admin API. При конвертации конфигурации из v3 часть полей отбрасывается осознанно (static, comment, title, segment_duration, https-слушатели и другие) — отчет о потерях доступен при конвертации.

Токены

Legacy-выдача принимает ?token= и Authorization: Bearer. Для этих URL токен в query имеет приоритет над заголовком.

Что дальше