Совместимость с 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 имеет приоритет над заголовком.