Эти руководства сопоставляют понятия отрасли с объектами, которые в платформе есть сегодня (букеты, линии, пакеты, аккаунты реселлеров, ноды, API). Это концептуальные соответствия, а не отраслевые функции, и аккаунт реселлера — делегированный аккаунт, а не изолированный тенант.
Концептуальное соответствие
В панели ничто не называется залом или членом клуба. Таблица показывает, какой объект какую роль играет; главы ниже настраивают их в этом порядке.
| В вашей отрасли | На платформе | Где в панели |
|---|---|---|
| Фильмы выставок и архив | VOD-каталог: фильмы и сериалы с сезонами и эпизодами, категориями и метаданными | Movies и Series либо задача загрузки VOD |
| Трансляция открытия или лекции | Прямой канал: стрим со своими источниками, EPG и форматами вывода | Streams → добавить прямой стрим (URL источника или RTMP-поток) |
| Коллекция залов или членов клуба | Букет: именованный набор каналов, фильмов или сериалов, который открывает пакет | Bouquets, из Streams и Movies / Series |
| Доступ посетителя или члена клуба | Линия: один доступ со своим пакетом, букетами, сроком действия, лимитом подключений и выводами | Lines → добавить, либо коды активации, либо Reseller API |
| Срок членства | Срок действия линии, который продлевается пакетом, кредитом или через API | Срок действия линии и длительность пакета |
| Устройств на члена клуба | Максимум подключений линии: сколько устройств могут смотреть одновременно | Максимум подключений линии |
Требования
Что подготовить перед установкой.
- Сервер в здании (Ubuntu 22.04 или 24.04), установщик и сеть залов, которой будут пользоваться экраны и устройства членов клуба.
- Фильмы выставок, архивные записи, права на которые у вас есть, кодировщик для лекционного зала и экраны или медиаплееры для залов.
- Лицензионный ключ и, если в здании нет интернета, процедура офлайн-активации; а также решение о том, кто на стойке продаёт членства.
Развёртывание инфраструктуры
Сервер в здании, активированный на месте.
- Запустите установщик на сервере и задайте базовый URL воспроизведения на адрес, доступный в сети залов.
- Активируйте лицензионный ключ офлайн из панели; после активации сервис работает в локальной сети без интернета.
- Добавьте фильмы выставок в Movies, а поток лекционного зала — в Streams и проверьте их в веб-плеере.
- Для второй площадки или большой публичной программы зарегистрируйте ноду в разделе Servers; панель устанавливает её по SSH и направляет на неё зрителей этой площадки.
Организация контента
Залы, архив и коллекции для членов клуба.
- Создайте категории по выставкам и по годам и сериал для цикла лекций с серией на каждую лекцию.
- Создайте один букет для экранов в залах и один для библиотеки лекций и архивных материалов для членов клуба.
- Создайте пакет для залов и по одному на вид членства, каждый выдаёт свои букеты; срок действия членского пакета — период членства.
- Добавьте постеры и краткие описания к каждому фильму, чтобы библиотека хорошо читалась в плеере.
Настройка партнёров (реселлеров)
Стойка и магазин как делегированные аккаунты.
- Создайте группу с правами только на линии и коды активации, без доступа к каталогу и серверам.
- Добавьте стойку или магазин как реселлера с этой группой, членскими пакетами и балансом кредитов.
- Культурный центр с несколькими площадками может добавить реселлера на каждую площадку, и каждый продаёт членства со своего баланса.
Настройка доступа посетителей и членов клуба
Экраны и члены клуба на линиях.
- Создайте по одной линии на экран зала через Lines → add с пакетом залов и привяжите её к адресу экрана, если сеть выдаёт фиксированные адреса.
- Создавайте коды активации на стойке для каждого проданного членства; член клуба вводит код в плеере, и линия начинает работать.
- Задайте максимальное число подключений на членство по числу устройств, которыми может пользоваться член клуба, обычно два.
- Передайте члену клуба приложение-плеер, плейлист M3U или адрес веб-плеера — в зависимости от его устройства.
Фильмы выставок и архив
Библиотека по запросу.
- Загрузите фильмы выставок и оцифрованный архив как фильмы либо загрузите их заданием VOD ingest в медиакаталог.
- Добавьте метаданные TMDB там, где они есть, а название и описание для остального напишите сами.
- Держите архив, не предназначенный для публики, только в букете членов клуба и проверьте, что видит каждый пакет, с тестовой линией.
Открытия и лекции
Мероприятие как прямой канал.
- Добавьте прямой поток для кодировщика лекционного зала (RTMP push) и поместите его в букет членов клуба либо в букет залов для открытия, которое показывают на экранах.
- Включите catch-up, чтобы пришедший позже член клуба мог перемотать назад, и затем загрузите запись в библиотеку.
- Проверьте кодировщик и поток до мероприятия с тестовой линией, в той же сети, которой будет пользоваться аудитория.
Срок членства и продление
Членство как срок действия линии.
- Линия истекает в конце периода своего пакета; продление на стойке добавляет ещё один период.
- Отключите линию, когда членство отменено; коды активации, которые так и не использовались, остаются неиспользованными, пока их не погасят.
- Подпишите магазин или систему членства на webhooks, чтобы видеть линии, которые скоро истекут или уже истекли.
Интеграция с магазином или системой членства
Системы продают доступ, плеер воспроизводит.
- Создайте ключ Reseller API для магазина или системы членства; она вызывает create_line, renew_line и disable_line с идентификатором запроса при каждой записи.
- Используйте торговый коннектор, когда членства продаются онлайн; любая другая система использует Reseller API и webhooks.
- Единого входа (SSO) для зрителей нет: член клуба входит в плеер с учётными данными линии или кодом активации.
Вопросы безопасности
Держите коллекции там, где им место.
- Держите сеть залов отдельно от сети посетителей, а любой публичный доступ отдавайте за reverse proxy с TLS и заданным TRUSTED_PROXIES.
- Двухфакторный вход для каждого аккаунта панели; стойка получает группу прав, ограниченную линиями и кодами.
- Подписанные и истекающие ссылки воспроизведения, лимит подключений на членство и привязка экранов в залах к адресу.
- Включите зашифрованную резервную копию базы данных с копией вне площадки и просматривайте изменения линий и каталога в журнале аудита.
Устранение неполадок
Обычные первые проверки.
- Экран в зале чёрный: проверьте, что его линия включена и не истекла, привязку экрана к адресу и доступность сервера в сети залов.
- Код члена клуба не работает: проверьте, что код ещё не погашен и что открываемый им пакет по-прежнему назначен стойке.
- Активация лицензии офлайн не проходит: сверьте файл активации с лицензионным ключом и проверьте часы сервера.
- Прямое открытие подтормаживает: сравните битрейт кодировщика с исходящим каналом и проверьте статус потока в Streams.