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ę galerią ani członkiem. 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 |
|---|---|---|
| Film wystawy i archiwum | Katalog VOD: filmy i seriale z sezonami i odcinkami, kategorie i metadane | Movies i Series lub zadanie pobierania VOD |
| Transmisja otwarcia lub wykładu | 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) |
| Kolekcja galerii lub członków | Bukiet: nazwany zestaw kanałów, filmów lub seriali przyznawany przez pakiet | Bouquets, ze Streams oraz Movies / Series |
| Dostęp zwiedzającego lub członka | 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 |
| Okres członkostwa | Data wygaśnięcia linii, odnawiana przez pakiet, kredyt lub API | Data wygaśnięcia linii i czas trwania pakietu |
| Urządzenia na członka | Maks. liczba połączeń linii: ile urządzeń może oglądać jednocześnie | Maks. liczba połączeń linii |
Wymagania wstępne
Co mieć przed instalacją.
- Serwer w budynku (Ubuntu 22.04 lub 24.04), instalator i sieć galerii, z której będą korzystać ekrany i urządzenia członków.
- Film wystawy, nagrania archiwalne, do których masz prawa, enkoder dla sali wykładowej oraz ekrany lub odtwarzacze multimediów dla galerii.
- Klucz licencji i, jeśli budynek nie ma internetu, procedurę aktywacji offline oraz decyzję, kto przy kasie sprzedaje członkostwa.
Wdrożenie infrastruktury
Serwer w budynku, aktywowany na miejscu.
- Uruchom instalator na serwerze i ustaw bazowy URL odtwarzania na adres dostępny w sieci galerii.
- Aktywuj klucz licencji offline z panelu; po aktywacji usługa działa w sieci lokalnej bez internetu.
- Dodaj film wystawy w sekcji Filmy i sygnał sali wykładowej w sekcji Streamy oraz sprawdź je w odtwarzaczu webowym.
- Dla drugiej lokalizacji lub dużego programu publicznego zarejestruj węzeł w sekcji Serwery; panel instaluje go przez SSH i kieruje do niego widzów tej lokalizacji.
Organizacja treści
Galerie, archiwum i kolekcje dla członków.
- Utwórz kategorie według wystawy i roku oraz serial dla cyklu wykładów z jednym odcinkiem na wykład.
- Utwórz jeden bukiet dla ekranów w galeriach i jeden dla biblioteki członków z wykładami i filmami archiwalnymi.
- Utwórz pakiet dla galerii i jeden na rodzaj członkostwa, każdy przyznający swoje bukiety; czas trwania pakietu członkowskiego to okres członkostwa.
- Dodaj plakaty i krótkie opisy do każdego filmu, aby biblioteka dobrze wyglądała w odtwarzaczu.
Konfiguracja partnerów (resellerów)
Kasa i sklep jako konta delegowane.
- Utwórz grupę z uprawnieniami ograniczonymi do linii i kodów aktywacyjnych, bez dostępu do katalogu i serwerów.
- Dodaj kasę lub sklep jako resellera z tą grupą, pakietami członkowskimi i saldem kredytów.
- Ośrodek kultury prowadzący kilka placówek może dodać resellera na placówkę, każdego sprzedającego członkostwa z własnego salda.
Konfiguracja dostępu zwiedzających i członków
Ekrany i członkowie na liniach.
- Utwórz jedną linię na ekran w galerii w sekcji Linie → dodaj z pakietem galerii i przypisz ją do adresu ekranu, gdy sieć nadaje stałe adresy.
- Twórz kody aktywacyjne przy kasie dla każdego sprzedanego członkostwa; członek wpisuje kod w odtwarzaczu i linia startuje.
- Ustaw maksymalną liczbę połączeń na członkostwo na liczbę urządzeń, których może używać członek, zwykle dwa.
- Przekaż członkowi aplikację odtwarzacza, playlistę M3U lub adres odtwarzacza webowego, zależnie od jego urządzenia.
Film wystawy i archiwum
Biblioteka na żądanie.
- Prześlij film wystawy i zdigitalizowane archiwum jako filmy albo zaimportuj je zadaniem importu VOD do katalogu mediów.
- Dodaj metadane TMDB tam, gdzie istnieją, a tytuł i opis pozostałych napisz samodzielnie.
- Trzymaj archiwum, które nie jest dla publiczności, wyłącznie w bukiecie członków i sprawdź linią testową, co widzi każdy pakiet.
Otwarcia i wykłady
Wydarzenie jako kanał na żywo.
- Dodaj stream na żywo dla enkodera sali wykładowej (push RTMP) i umieść go w bukiecie członków albo w bukiecie galerii dla otwarcia pokazywanego na ekranach.
- Włącz catch-up, aby członek, który przyjdzie późno, mógł przewinąć wstecz, i prześlij nagranie do biblioteki po wydarzeniu.
- Przetestuj enkoder i stream przed wydarzeniem linią testową, w tej samej sieci, z której skorzysta widownia.
Wygasanie i odnawianie członkostwa
Członkostwo jako ważność linii.
- Linia wygasa z końcem okresu swojego pakietu; odnowienie przy kasie dodaje kolejny okres.
- Wyłącz linię, gdy członkostwo zostaje anulowane; kody aktywacyjne, które nigdy nie zostały użyte, pozostają nieużyte do momentu realizacji.
- Zasubskrybuj webhooki w sklepie lub systemie członkowskim, aby widzieć linie, które zaraz wygasną lub już wygasły.
Integracja ze sklepem lub systemem członkowskim
Systemy sprzedają dostęp; odtwarzacz odtwarza.
- Utwórz klucz Reseller API dla sklepu lub systemu członkowskiego; wywołuje on create_line, renew_line i disable_line, z identyfikatorem żądania przy każdym zapisie.
- Użyj konektora handlowego, gdy członkostwa są sprzedawane online; każdy inny system korzysta z Reseller API i webhooków.
- Nie ma logowania jednokrotnego dla widzów: członek loguje się do odtwarzacza danymi linii lub kodem aktywacyjnym.
Kwestie bezpieczeństwa
Trzymaj kolekcje tam, gdzie ich miejsce.
- Oddziel sieć galerii od sieci zwiedzających, a każdy dostęp publiczny udostępniaj za reverse proxy z TLS i ustawionym TRUSTED_PROXIES.
- Logowanie dwuskładnikowe dla każdego konta panelu; kasa dostaje grupę uprawnień ograniczoną do linii i kodów.
- Podpisane i wygasające linki odtwarzania, limit połączeń na członkostwo i przypisanie ekranów galerii do adresu.
- Włącz szyfrowaną kopię zapasową bazy z kopią zewnętrzną i używaj dziennika audytu do przeglądu zmian linii i katalogu.
Rozwiązywanie problemów
Typowe pierwsze kontrole.
- Ekran w galerii jest czarny: sprawdź, czy jego linia jest włączona i nie wygasła, przypisanie do adresu ekranu oraz czy serwer jest osiągalny w sieci galerii.
- Kod członka nie działa: sprawdź, czy kod nie został już zrealizowany i czy pakiet, który otwiera, jest nadal przypisany do kasy.
- Aktywacja licencji offline kończy się niepowodzeniem: sprawdź plik aktywacyjny względem klucza licencji oraz zegar serwera.
- Otwarcie na żywo się zacina: sprawdź bitrate enkodera względem łącza wychodzącego i status streamu w sekcji Streamy.