Te przewodniki odwzorowują pojęcia branży na obiekty, które platforma ma dziś (bukiety, linie, pakiety, konta partnerów, węzły, API). To odwzorowania koncepcyjne, a nie funkcje specyficzne dla branż, a konto partnera jest kontem delegowanym, a nie odizolowanym najemcą.
Odwzorowanie koncepcyjne
Nic w panelu nie nazywa się sceną ani biletem. Tabela mówi, który obiekt pełni jaką rolę; kolejne rozdziały konfigurują je w tej kolejności.
| W Twojej branży | Na platformie | Gdzie w panelu |
|---|---|---|
| Kanał sceny | Kanał na żywo: strumień ze źródłami, EPG i formatami wyjściowymi | Streams → dodaj strumień na żywo (adres źródła lub wysyłka RTMP) |
| Typ biletu | Bukiet: nazwany zestaw kanałów, filmów lub seriali przyznawany przez pakiet | Bouquets, ze Streams oraz Movies / Series |
| Bilet lub karnet | Linia: jeden dostęp z pakietem, bukietami, datą wygaśnięcia, limitem połączeń i wyjściami | Lines → dodaj, albo kody aktywacyjne, albo Reseller API |
| Koniec wydarzenia | Data wygaśnięcia linii, odnawiana przez pakiet, kredyt lub API | Data wygaśnięcia linii i czas trwania pakietu |
| Urządzenia na bilet | Maks. liczba połączeń linii: ile urządzeń może oglądać jednocześnie | Maks. liczba połączeń linii |
| Integracja z biletami lub rejestracją | Reseller API i webhooki: operacje panelu z Twojego własnego systemu | Klucze Reseller API i webhooki w panelu resellera |
| Węzeł w obiekcie | Węzły streamingu: serwery brzegowe zarejestrowane z panelu, po jednym na lokalizację lub budynek | Servers → dodaj węzeł, instalowany przez SSH |
Wymagania wstępne
Co mieć przed instalacją.
- Serwer (Ubuntu 22.04 lub 24.04) z publicznym adresem lub domeną i łączem wychodzącym na oczekiwany szczyt widowni oraz, dla węzła w obiekcie, maszynę w sieci obiektu.
- Enkoder na scenę, który potrafi wysyłać RTMP, oraz listę scen, dni i typów biletów.
- Decyzję, jak bilety trafiają do panelu: kody aktywacyjne generowane hurtowo albo system biletowy wywołujący Reseller API.
Wdrożenie infrastruktury
Najpierw origin, potem obiekt.
- Uruchom instalator na serwerze zarządzającym i umieść panel za reverse proxy z TLS; ustaw zaufane proxy, aby reguły IP widziały prawdziwy adres widza.
- Ustaw bazowy URL odtwarzania na publiczny adres, pod którym łączą się uczestnicy.
- Zarejestruj węzeł w sekcji Serwery na maszynie w obiekcie; panel instaluje go przez SSH, a lokalne ekrany są do niego kierowane.
- Utwórz konto partnerskie (reseller) dla punktu biletowego z uprawnieniami do linii i bez uprawnień do katalogu.
Organizacja treści
Sceny jako kanały, bilety jako pakiety.
- Dodaj kategorie na dzień lub ścieżkę tematyczną, aby lista kanałów czytała się jak program.
- Utwórz jeden bukiet na typ biletu: sceny, które ten bilet może oglądać.
- Utwórz jeden pakiet na typ biletu z długością wydarzenia jako czasem trwania oraz w razie potrzeby pakiet próbny dla prasy i prelegentów.
- Utwórz bukiet dla sceny sponsorów lub sygnału z lounge i przyznawaj go wyłącznie przez pakiet sponsora.
Konfiguracja partnerów (resellerów)
Punkt biletowy, jeśli wydaje dostęp.
- Utwórz dla punktu biletowego grupę z uprawnieniami do linii i bez uprawnień do katalogu.
- Dodaj punkt jako resellera z tą grupą i wystarczającą liczbą kredytów na kody, które wyda.
- Współorganizator lub partner regionalny sprzedający własne bilety dostaje własne konto partnerskie i własne pakiety.
Konfiguracja dostępu uczestników
Jedna linia na bilet.
- Wygeneruj kody aktywacyjne hurtowo, po jednym na bilet, każdy powiązany z pakietem swojego typu biletu, i wydrukuj je lub wyślij e-mailem razem z biletem.
- Przy sprzedaży biletów online zainstaluj konektor swojej platformy handlowej albo niech system biletowy wywołuje action=create_line z pakietem i identyfikatorem żądania.
- Ustaw maksymalną liczbę połączeń na jedno lub dwa urządzenia na bilet, aby kod nie mógł krążyć wśród widowni.
- Przetestuj linią próbną przed otwarciem drzwi, używając tego samego odtwarzacza, którego użyją uczestnicy.
Nagrania sesji
Nagrania po wydarzeniu.
- Nagrywaj każdą scenę i dodaj pliki do biblioteki jako odcinki serialu na ścieżkę tematyczną albo zaimportuj je zadaniem importu VOD.
- Przyznaj nagrania przez osobny bukiet i pakiet, aby uczestnicy zachowali dostęp po wygaśnięciu linii na żywo.
- Sprawdź odtwarzanie nagrań linią testową tego pakietu, zanim je ogłosisz.
Kanały scen
Scena jako kanał na żywo.
- Dodaj stream na żywo na scenę z pushem RTMP z enkodera i umieść go w bukietach typów biletów, które mogą go oglądać.
- Włącz catch-up, aby uczestnik, który przegapił początek sesji, mógł przewinąć wstecz.
- Przed pierwszą sesją sprawdź, czy węzeł w obiekcie pobiera każdą scenę raz z origin i czy ekrany są do niego kierowane.
Wygasanie
Dostęp kończy się z wydarzeniem.
- Nadaj każdemu pakietowi biletu czas trwania kończący się ostatniego dnia wydarzenia, aby linie wygasły bez żadnej pracy.
- Przedłuż jedną linię lub wydaj krótkotrwały kod dla prelegenta albo spóźnionego sponsora zamiast tworzyć nowy pakiet.
- Wyłącz linię zgubionego lub współdzielonego biletu w sekcji Linie; dziennik audytu zachowuje zapis.
Integracja z systemem biletowym
Systemy sterują dostępem; odtwarzacz odtwarza.
- System biletowy lub rejestracji tworzy linie przez Reseller API i nasłuchuje webhooków takich jak line.created i line.expired.
- Sprzedaż biletów online na obsługiwanej platformie handlowej korzysta z jej konektora; nie ma natywnego konektora dla konkretnego produktu biletowego.
- Nie ma logowania jednokrotnego dla widzów: uczestnik loguje się do odtwarzacza danymi linii lub kodem aktywacyjnym.
Kwestie bezpieczeństwa
Bilet to jedna osoba.
- Udostępniaj panel i bazowy URL odtwarzania przez TLS i ustaw TRUSTED_PROXIES na swoje reverse proxy.
- Logowanie dwuskładnikowe dla każdego konta panelu oraz grupy uprawnień, aby punkt biletowy nie mógł zmieniać scen.
- Podpisane i wygasające linki odtwarzania oraz niski limit połączeń na bilet.
- Szyfrowane kopie zapasowe bazy z kopią zewnętrzną oraz dziennik audytu każdej zmiany linii i scen.
Rozwiązywanie problemów
Typowe pierwsze kontrole.
- Uczestnik nie może otworzyć sceny: sprawdź pakiet linii, bukiet zawierający scenę i datę ważności.
- Scena zawiesza się na sali, ale nie online: sprawdź heartbeat węzła w obiekcie i trasę ekranów do niego.
- Kod aktywacyjny jest odrzucany: sprawdź, czy nie został już użyty i czy jego pakiet jest nadal ważny.
- Dziennik audytu pokazuje adres proxy: ustaw TRUSTED_PROXIES na to proxy i zrestartuj panel.