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ę programem ani wspierającym. 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ł studia | 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) |
| Biblioteka programów | Katalog VOD: filmy i seriale z sezonami i odcinkami, kategorie i metadane | Movies i Series lub zadanie pobierania VOD |
| Poziom subskrypcji | Bukiet: nazwany zestaw kanałów, filmów lub seriali przyznawany przez pakiet | Bouquets, ze Streams oraz Movies / Series |
| Dostęp wspierającego | 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 rozliczeniowy | Data wygaśnięcia linii, odnawiana przez pakiet, kredyt lub API | Data wygaśnięcia linii i czas trwania pakietu |
| Konto afilianta lub dystrybutora | Konto partnera (reseller): delegowany panel z kredytami, uprawnieniami i własnymi liniami | Users → dodaj resellera; Groups dla jego uprawnień |
| Integracja ze sklepem lub członkostwem | Reseller API i webhooki: operacje panelu z Twojego własnego systemu | Klucze Reseller API i webhooki w panelu resellera |
Wymagania wstępne
Co mieć przed instalacją.
- Serwer (Ubuntu 22.04 lub 24.04) z publicznym adresem lub domeną i wystarczającą przepustowością wysyłania dla oczekiwanej widowni.
- Gotowe odcinki, playout lub enkoder studia dla kanału oraz sklep na platformie z konektorem albo możliwość wywoływania API HTTP.
- Decyzję o poziomach i afiliantach: co daje każda subskrypcja i kto może ją sprzedawać.
Wdrożenie infrastruktury
Najpierw jeden serwer, węzły w miarę wzrostu widowni.
- 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 łączy się Twoja widownia.
- Zarejestruj węzeł w sekcji Serwery w regionie, gdzie ogląda wielu wspierających; panel instaluje go przez SSH i kieruje do niego widzów tego regionu.
- Utwórz konto partnerskie (reseller) dla każdego członka zespołu, który prowadzi katalog lub wspierających, z własną grupą uprawnień.
Organizacja treści
Programy jako seriale, poziomy jako bukiety.
- Utwórz kategorie według gatunku oraz jeden serial na program, z sezonem na partię wydań i jednym odcinkiem na wideo.
- Utwórz bukiet dla kanału na żywo, jeden dla treści bezpłatnych lub wstępnych i po jednym dla każdego wyższego poziomu.
- Utwórz jeden pakiet na poziom z okresem rozliczeniowym jako czasem trwania, pakiet próbny dla nowych odwiedzających, jeśli chcesz, oraz cenę w kredytach dla afiliantów.
- Trzymaj katalog archiwalny we własnej kategorii, aby można go było przenosić między poziomami bez ruszania seriali.
Konfiguracja partnerów (resellerów)
Afilianci i dystrybutorzy.
- Utwórz grupę dla afiliantów wyłącznie z uprawnieniami do linii, aby nie mogli zmieniać katalogu.
- Dodaj każdego afilianta jako resellera z tą grupą i saldem kredytów; cena jego pakietu zależy od decyzji studia.
- Dystrybutor z pod-afiliantami może tworzyć sub-resellerów w ramach własnego konta, do pięciu poziomów w głąb.
Konfiguracja dostępu wspierających
Jedna linia na wspierającego.
- Zainstaluj konektor swojego sklepu (na przykład WooCommerce) i wpisz klucz Reseller API oraz pakiet odpowiadający każdemu produktowi.
- Przy subskrypcji konektor wywołuje create_line z pakietem i identyfikatorem żądania; okres rozliczeniowy to czas trwania pakietu.
- Ustaw maksymalną liczbę połączeń na liczbę urządzeń, których może używać wspierający, zwykle dwa lub trzy.
- Na potrzeby konkursu lub premiery wygeneruj kody aktywacyjne hurtowo albo dodaj linie w sekcji Linie → dodaj z pakietem próbnym.
Biblioteka programów
Odcinki na żądanie.
- Prześlij każdy odcinek jako źródło albo zaimportuj go zadaniem importu VOD; uzupełnij tytuł, sezon, numer odcinka i metadane TMDB, jeśli program je ma.
- Przypisz każdy serial do bukietów poziomów, które mogą go oglądać.
- Sprawdź odtwarzanie linią testową każdego poziomu, zanim ogłosisz premierę.
Kanał studia
Kanał przez całą dobę.
- Dodaj stream na żywo dla playoutu studia (push RTMP) i umieść go w bukietach każdego poziomu, który obejmuje kanał.
- Wczytaj przewodnik kanału jako XMLTV, aby wspierający widzieli, co leci, i włącz catch-up dla programów wartych powtórki.
- Utrzymuj działanie playoutu między premierami za pomocą własnych zaplanowanych treści studia; panel tylko retransmituje strumień.
Wygasanie subskrypcji
Dostęp podąża za płatnością.
- Linia wygasa z końcem okresu swojego pakietu; sklep odnawia ją przez renew_line, gdy przychodzi kolejna płatność.
- Zasubskrybuj w sklepie webhooki, aby wysyłać przypomnienie przy line.expiring i obniżać poziom wspierającego przy line.expired.
- Wspierający, który rezygnuje, jest wyłączany przez sklep za pomocą disable_line, a linię można później odnowić bez nowego konta.
Integracja ze sklepem
Sklep sprzedaje; odtwarzacz odtwarza.
- Konektor tworzy, odnawia i wyłącza linie zgodnie z zamówieniami; każdy inny sklep korzysta z Reseller API i webhooków.
- Afilianci widzą własne linie w swoim panelu, a Reseller API pozwala im to zautomatyzować.
- Nie ma logowania jednokrotnego dla widzów: wspierający logują się do odtwarzacza danymi swojej linii, które wysyła im sklep.
Kwestie bezpieczeństwa
Chroń subskrypcję, nie tylko serwer.
- 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 afilianci nie mogli zmieniać katalogu.
- Podpisane i wygasające linki odtwarzania oraz limit połączeń na linię; przypisz linię do kraju, jeśli licencja jest terytorialna.
- Szyfrowane kopie zapasowe bazy z kopią zewnętrzną oraz dziennik audytu każdej zmiany linii i katalogu.
Rozwiązywanie problemów
Typowe pierwsze kontrole.
- Nowy wspierający nie może oglądać po zapłaceniu: sprawdź wywołanie konektora sklepu w logu Reseller API i datę ważności linii.
- Wspierający widzi treści wyższego poziomu: sprawdź pakiet linii i bukiety, które przyznaje.
- Kanał zatrzymuje się na końcu cyklu playoutu: sprawdź push enkodera do streamu na żywo i status sondowania streamu.
- Sprzedaż afilianta się nie pojawia: sprawdź jego kredyty i czy użyty pakiet należy do jego grupy.