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ę pokojem ani pobytem. Tabela mówi, który obiekt pełni jaką rolę; poniższe rozdziały ustawiają je w tej kolejności.
| W Twojej branży | Na platformie | Gdzie w panelu |
|---|---|---|
| Operator hotelu lub autoryzowany partner | Konto partnera (reseller): delegowany panel z kredytami, uprawnieniami i własnymi liniami | Users → dodaj resellera; Groups dla jego uprawnień |
| Pakiet kanałów | Bukiet: nazwany zestaw kanałów, filmów lub seriali przyznawany przez pakiet | Bouquets, ze Streams oraz Movies / Series |
| Pokój lub urządzenie | 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 |
| Filmy informacyjne hotelu | Katalog VOD: filmy i seriale z sezonami i odcinkami, kategorie i metadane | Movies i Series lub zadanie pobierania VOD |
| Licencjonowane kanały telewizyjne | 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) |
| Długość pobytu | Data wygaśnięcia linii, odnawiana przez pakiet, kredyt lub API | Data wygaśnięcia linii i czas trwania pakietu |
| Jeden węzeł na budynek lub skrzydło | 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 w sieci obiektu (Ubuntu 22.04 lub 24.04), instalator i adres, do którego mają dostęp urządzenia w pokojach.
- Strumienie kanałów, do których obiekt posiada prawa (adresy do pobierania lub RTMP), filmy informacyjne hotelu i urządzenia w pokojach (dekodery Android TV, dekodery MAG lub Enigma2, smart TV z aplikacją odtwarzacza lub przeglądarką).
- Możliwość wywołania przez PMS API HTTP przy zameldowaniu i wymeldowaniu albo procedura recepcji do wykonywania tego w panelu.
Wdrożenie infrastruktury
Serwer centralny i węzeł na budynek.
- Uruchom instalator na serwerze centralnym; ustaw bazę odtwarzania na wewnętrzny adres obiektu, aby pokoje pozostały w sieci lokalnej.
- Dodaj strumienie kanałów w Streams, a filmy informacyjne w Movies; sprawdź je w odtwarzaczu webowym.
- Zarejestruj węzeł na skrzydło lub budynek w Servers; panel instaluje go przez SSH i kieruje do niego pokoje tego budynku.
- Ustaw klucz licencyjny na serwerze; aktywacja następuje na miejscu, a usługa działa bez łącza zewnętrznego.
Organizacja treści
Pakiety kanałów i filmy hotelu.
- Utwórz jeden bukiet na pakiet kanałów (pokoje standardowe, apartamenty, konferencje) z kanałów obiektu.
- Utwórz bukiet filmów hotelu (powitanie, udogodnienia, bezpieczeństwo) i dodaj go do każdego pakietu.
- Utwórz jeden pakiet na kategorię pokoju z bukietami, które przyznaje, i czasem trwania jednego dnia: przy zameldowaniu linia pokoju jest odnawiana raz za każdą noc pobytu (każde odnowienie dodaje czas trwania pakietu), a przy wymeldowaniu jest wyłączana (rozdział 8).
- Uporządkuj kanały i nadaj im logo, aby menu na telewizorze dobrze się czytało.
Konfiguracja partnerów (resellerów)
Obiekt lub operator prowadzący kilka obiektów jako konto delegowane.
- Utwórz grupę z uprawnieniami ograniczonymi do linii (pokoi) i bez zmian w katalogu.
- Dodaj recepcję obiektu lub operatora jako resellera z tą grupą i pakietami pokoi.
- Operator kilku obiektów dostaje jednego resellera na obiekt, każdego z własnymi pokojami i kredytami.
Konfiguracja pokoju (linii)
Jedna linia na pokój, nazwana jego numerem.
- Utwórz jedną linię na pokój w Lines z numerem pokoju jako nazwą i pakietem kategorii pokoju.
- Ustaw maks. liczbę połączeń na 1 (jeden telewizor) lub na liczbę ekranów w pokoju.
- Powiąż linię z adresem urządzenia w pokoju, gdy sieć nadaje urządzeniom stałe adresy.
- Skonfiguruj urządzenie raz (API Xtream Codes lub M3U z danymi dostępowymi linii, albo portal MAG / Enigma2); dane dostępowe zostają przy pokoju.
Filmy informacyjne hotelu
Własne filmy obiektu na żądanie.
- Prześlij filmy powitalne i informacyjne jako filmy, z wersjami językowymi obiektu jako osobnymi pozycjami lub ścieżkami audio.
- Umieść je w bukiecie filmów hotelu, aby otrzymała je każda kategoria pokoju.
- Aktualizuj je z panelu, gdy zmienią się informacje; pokoje widzą nową wersję od razu.
Licencjonowane kanały telewizyjne
Kanały obiektu jako strumienie na żywo.
- Dodaj każdy licencjonowany kanał w Streams z jego strumieniem; włącz timeshift lub catch-up tylko tam, gdzie pozwala na to licencja.
- Dodaj źródło EPG, aby przewodnik na telewizorze pokazywał programy.
- Kanały ograniczone terytorialnie trzymaj w bukietach przyznawanych tylko przez właściwe pakiety.
Zameldowanie, wymeldowanie i wygaśnięcie
Pobyt jako ważność linii.
- Przy zameldowaniu włącz linię pokoju i odnów ją na długość pobytu (PMS przez API lub recepcja w panelu).
- Przy wymeldowaniu wyłącz linię; nowy pobyt włącza ją ponownie, więc dane dostępowe nigdy nie opuszczają pokoju.
- Zasubskrybuj webhooki w PMS lub w recepcji, aby widzieć włączone, wyłączone i wygasłe linie.
Integracja z PMS
Zameldowanie i wymeldowanie sterują pokojami.
- Utwórz klucz Reseller API dla PMS i trzymaj go w konfiguracji PMS.
- Przy zameldowaniu PMS wywołuje action=enable_line i action=renew_line dla linii pokoju z identyfikatorem żądania; przy wymeldowaniu action=disable_line.
- Aplikacja usług dla gości (wezwanie obsługi, housekeeping, ekspresowe wymeldowanie, room service) i jej połączenie z back-office są częścią planu Enterprise i są zakresowane razem z obiektem.
Kwestie bezpieczeństwa
Utrzymaj kanały wewnątrz obiektu.
- Trzymaj bazę odtwarzania i węzły w sieci obiektu; nie wystawiaj do internetu niczego, czego pokoje nie potrzebują.
- Jedno połączenie na pokój, powiązane z urządzeniem; podpisane linki wygasają, więc skopiowany link przestaje działać.
- Logowanie dwuskładnikowe do panelu; recepcja dostaje ograniczoną grupę uprawnień.
- Włącz szyfrowaną kopię zapasową bazy danych; dane dostępowe pokoi w niej są.
Rozwiązywanie problemów
Typowe pierwsze kontrole.
- Pokój nie ma telewizji: sprawdź, czy jego linia jest włączona i niewygasła, potem dane dostępowe i adres urządzenia.
- W pokoju brakuje kanału: sprawdź bukiet pakietu kategorii pokoju.
- Telewizja zatrzymuje się podczas awarii internetu: sprawdź, czy baza odtwarzania i źródła mają adresy wewnętrzne; zewnętrzne strumienie zależą od łącza.
- Wywołanie PMS kończy się błędem: sprawdź klucz API, czy zapisy to POST, i identyfikator żądania przy ponowieniach.