Перейти к содержимому
Продукты

Интеграция с Ministra (Stalker) Middleware

Ministra TV Platform (ранее Stalker Middleware) управляет абонентами, приставками и списком каналов. Alta доставляет каналы и ТВ-архив. Ministra взаимодействует с Alta так же, как с Flussonic: она добавляет временный токен к каждой ссылке на канал, а Alta проверяет токен в Ministra перед началом воспроизведения.

В этой статье пошагово показано, как подключить Alta к Ministra: каналы в прямом эфире с временными ссылками, ТВ-архив (catch-up) и timeshift.

Взаимодействие Alta и Ministra

  1. Абонент открывает канал на приставке.
  2. Ministra создаёт временный токен и возвращает ссылку на канал с этим токеном: http://alta.example.com:8102/demo/index.m3u8?token=41771f02a48d1fef09eebe9f0efdaeb8
  3. Приставка запрашивает плейлист у Alta.
  4. Alta отправляет токен в Ministra: http://stalker.example.com/stalker_portal/server/api/chk_flussonic_tmp_link.php?token=...
  5. Ministra отвечает 200 OK, если токен действителен, или 403 Forbidden в противном случае.
  6. Alta возвращает приставке плейлист и поток либо 403 Forbidden.

Токен проверяется один раз, при запросе плейлиста. После этого приставка воспроизводит поток в рамках своей сессии в Alta. По умолчанию токен для прямого эфира действует 5 секунд: приставка получает новый токен каждый раз, когда открывает канал. Токены для ТВ-архива действуют 8 часов.

Для ТВ-архива Ministra использует формат ссылок Flussonic DVR. Alta поддерживает его из коробки:

ФункцияСсылка, создаваемая Ministra
Прямой эфирhttp://<alta>:<port>/<path>/index.m3u8?token=...
Timeshift (с начала текущего часа)http://<alta>:<port>/<path>/index-<start>-now.m3u8?token=...
Catch-up (передача из EPG)http://<alta>:<port>/<path>/archive-<start>-<duration>.m3u8?token=...

Подробнее об этих ссылках читайте в статье Формат URL для доступа по HLS.

  • Приставки имеют доступ к порту OTT-сервера Alta (8102 в этом примере).
  • Alta имеет доступ к Ministra по HTTP (по умолчанию порт 80).
  • Для ТВ-архива: хранилище в Alta и EPG для каналов в Ministra.

В этой статье:

Адрес
OTT-сервер Altahttp://alta.example.com:8102
Ministrahttp://stalker.example.com/stalker_portal/
Путь канала в Altademo

Перейдите в Receivers → Create и добавьте источник канала. Подробнее в разделе Ресиверы.

Alta: создание ресивера

Хранилище необходимо для ТВ-архива и timeshift. Пропустите этот шаг, если вам нужны только каналы в прямом эфире.

Перейдите в Settings → Storages → Create:

  • Name: archive
  • Duration: глубина архива в часах, например 24
  • Location: каталог для архива, например /var/lib/alta/archive

Alta: создание хранилища

Перейдите в Settings → Authorizers → Create:

  • Name: stalker
  • Default: Deny
  • Backends → Add Backend: http://stalker.example.com/stalker_portal/server/api/chk_flussonic_tmp_link.php

Alta: создание авторизатора

Перейдите в Channels → Create:

  • Enable: включено
  • Path: demo. Канал доступен по адресу http://alta.example.com:8102/demo/index.m3u8
  • Name: Demo Channel
  • Variants → main: включите и выберите ресивер
  • Authorizer: stalker
  • Storage & Duration → Storage: archive (для ТВ-архива)

Alta: создание канала

Убедитесь, что канал защищён. Без токена Alta отвечает 403 Forbidden:

Окно терминала
curl -I http://alta.example.com:8102/demo/index.m3u8
HTTP/1.1 403 Forbidden

Пропустите этот шаг, если вам нужны только каналы в прямом эфире.

Перейдите в Storage → Storage list → Add storage:

  • Title: alta
  • IP: адрес и OTT-порт Alta без http://: alta.example.com:8102
  • Apache port: 8102. Поле обязательное, но для Flussonic DVR не используется
  • Maximum of users: например, 1000. Если поле пустое, приставки получают ошибку limit при открытии архива
  • Additional information → Allow TV recording: Flussonic DVR

Ministra: добавление хранилища

Перейдите в IPTV channels → Channels → Add a channel.

Basic:

  • Channel number, Channel name, Genre
  • Basic channel: включите, если вы не используете тарифные планы. В противном случае добавьте канал в пакет услуг, иначе абоненты его не увидят

Streaming links → Add link:

  • Channel URL: ffmpeg http://alta.example.com:8102/demo/index.m3u8
  • Temporary URL: Flussonic

Ministra: ссылка на поток

Нажмите Save в диалоге ссылки. Ссылка появится в таблице Streaming links со значением Temporary HTTP-link On:

Ministra: основные настройки канала

TV archive:

  • TV archive type: Flussonic DVR
  • Archive servers: alta
  • TV archive address: адрес канала в Alta без ffmpeg: http://alta.example.com:8102/demo/index.m3u8. Ministra формирует из него ссылки на архив
  • TV archive length: глубина архива в часах, такая же, как длительность хранилища в Alta, например 24

EPG:

  • XMLTV ID: ID канала в вашем источнике XMLTV. Catch-up работает только для передач из EPG

Ministra: ТВ-архив

Нажмите Save.

Добавьте абонента с MAC-адресом приставки в Users → Users list → Add user или используйте существующих абонентов.

  1. Откройте канал на приставке. Канал воспроизводится.
  2. В Alta откройте Sessions: в списке есть сессия приставки.
  3. Откройте ТВ-архив на приставке и воспроизведите передачу из прошлого.

Чтобы проверить соединение между Alta и Ministra, выполните эту команду на сервере Alta:

Окно терминала
curl -I "http://stalker.example.com/stalker_portal/server/api/chk_flussonic_tmp_link.php?token=test"

403 Forbidden означает, что Ministra доступна и, как и ожидалось, отклоняет неизвестный токен.

  • Проверьте адрес бэкенда в авторизаторе Alta с помощью команды curl, приведённой выше.
  • Проверьте, что Temporary URL в ссылке канала в Ministra имеет значение Flussonic. Без этого Ministra не добавляет токен.
  • Токен действует 5 секунд. Плеер, который открывает ту же ссылку позже, получает 403. Время задаётся опцией tv_tmp_link_ttl в custom.ini Ministra.

Alta записывает отклонённые запросы в журнал:

Окно терминала
journalctl -u alta | grep "Authorization denied"

Включите Basic channel для канала или добавьте его в пакет услуг тарифного плана абонента.

Задайте Maximum of users для сервера архива в Ministra.

Ministra использует часовой пояс PHP (default_timezone в custom.ini) и часовой пояс MySQL для расчёта времени передач. Если они различаются, ссылки на архив указывают на неверный диапазон времени. Задайте одинаковый часовой пояс для PHP и MySQL.