Tito průvodci promítají pojmy oboru do objektů, které platforma dnes má (bouquety, linky, balíčky, partnerské účty, uzly, API). Jde o konceptuální mapování, ne o funkce specifické pro obor, a partnerský účet je delegovaný účet, ne izolovaný tenant.
Konceptuální mapování
Nic v panelu se nenazývá pokoj ani pobyt. Tabulka říká, který objekt hraje jakou roli; níže uvedené kapitoly je nastavují v tomto pořadí.
| Ve vašem oboru | Na platformě | Kde v panelu |
|---|---|---|
| Provozovatel hotelu nebo autorizovaný partner | Partnerský účet (reseller): delegovaný panel s kredity, oprávněními a vlastními linkami | Users → přidat resellera; Groups pro jeho oprávnění |
| Balíček kanálů | Bouquet: pojmenovaná sada kanálů, filmů nebo seriálů, kterou balíček zpřístupní | Bouquets, ze Streams a Movies / Series |
| Pokoj nebo zařízení | Linka: jeden přístup se svým balíčkem, bouquety, expirací, limitem připojení a výstupy | Lines → přidat, nebo aktivační kódy, nebo Reseller API |
| Informační videa hotelu | VOD katalog: filmy a seriály se sezónami a epizodami, kategoriemi a metadaty | Movies a Series, nebo úloha ingestu VOD |
| Licencované televizní kanály | Živý kanál: stream se svými zdroji, EPG a výstupními formáty | Streams → přidat živý stream (URL zdroje nebo RTMP push) |
| Délka pobytu | Datum expirace linky, obnovované balíčkem, kreditem nebo přes API | Datum expirace linky a trvání balíčku |
| Jeden uzel na budovu nebo křídlo | Streamovací uzly: hraniční servery zaregistrované z panelu, jeden na lokalitu nebo budovu | Servers → přidat uzel, instalovaný přes SSH |
Předpoklady
Co mít připraveno před instalací.
- Server v síti ubytování (Ubuntu 22.04 nebo 24.04), instalátor a adresa, kterou zařízení v pokojích dosáhnou.
- Kanálové feedy, k nimž ubytování má práva (pull URL nebo RTMP), informační videa hotelu a zařízení v pokojích (boxy Android TV, boxy MAG nebo Enigma2, chytré televize s aplikací přehrávače nebo prohlížečem).
- Schopnost PMS volat HTTP API při příjezdu a odjezdu, nebo postup na recepci pro provedení v panelu.
Nasazení infrastruktury
Centrální server a uzel na budovu.
- Spusťte instalátor na centrálním serveru; nastavte základ přehrávání na interní adresu ubytování, aby pokoje zůstaly v lokální síti.
- Přidejte kanálové feedy v Streams a informační videa v Movies; zkontrolujte je ve webovém přehrávači.
- Zaregistrujte uzel na křídlo nebo budovu v Servers; panel jej nainstaluje přes SSH a nasměruje na něj pokoje té budovy.
- Nastavte licenční klíč na serveru; aktivace probíhá na místě a služba běží bez uplinku.
Organizace obsahu
Balíčky kanálů a videa hotelu.
- Vytvořte jeden bouquet na balíček kanálů (standardní pokoje, apartmá, konference) z kanálů ubytování.
- Vytvořte bouquet videí hotelu (uvítání, zařízení, bezpečnost) a přidejte jej do každého balíčku.
- Vytvořte jeden balíček na kategorii pokoje s bouquety, které poskytuje, a s délkou jednoho dne: při příjezdu se linka pokoje obnoví jednou za každou noc pobytu (každé obnovení přidá délku balíčku) a při odjezdu se deaktivuje (kapitola 8).
- Seřaďte kanály a dejte jim loga, aby se nabídka na televizi dobře četla.
Konfigurace partnerů (resellerů)
Ubytování, nebo provozovatel více ubytování, jako delegovaný účet.
- Vytvořte skupinu s oprávněními omezenými na linky (pokoje) a bez změn katalogu.
- Přidejte recepci ubytování, nebo provozovatele, jako resellera s touto skupinou a balíčky pokojů.
- Provozovatel více ubytování dostane jednoho resellera na ubytování, každého s vlastními pokoji a kredity.
Konfigurace pokoje (linky)
Jedna linka na pokoj, pojmenovaná jeho číslem.
- Vytvořte jednu linku na pokoj v Lines s číslem pokoje jako názvem a balíčkem kategorie pokoje.
- Nastavte max. připojení na 1 (jedna televize) nebo na počet obrazovek v pokoji.
- Svažte linku s adresou zařízení v pokoji, pokud síť přiděluje zařízením pevné adresy.
- Nastavte zařízení jednou (API Xtream Codes nebo M3U s údaji linky, nebo portál MAG / Enigma2); údaje zůstanou u pokoje.
Informační videa hotelu
Vlastní videa ubytování na vyžádání.
- Nahrajte uvítací a informační videa jako filmy, s jazykovými verzemi ubytování jako samostatnými záznamy nebo zvukovými stopami.
- Zařaďte je do bouquetu videí hotelu, aby je dostala každá kategorie pokoje.
- Aktualizujte je z panelu, kdykoli se informace změní; pokoje uvidí novou verzi okamžitě.
Licencované televizní kanály
Kanály ubytování jako živé streamy.
- Přidejte každý licencovaný kanál v Streams s jeho feedem; timeshift nebo catch-up zapněte jen tam, kde to licence dovoluje.
- Přidejte zdroj EPG, aby průvodce na televizi zobrazoval pořady.
- Kanály omezené územím držte v bouquetech, které zpřístupňují jen správné balíčky.
Příjezd, odjezd a expirace
Pobyt jako platnost linky.
- Při příjezdu aktivujte linku pokoje a obnovte ji na délku pobytu (PMS přes API, nebo recepce v panelu).
- Při odjezdu linku deaktivujte; nový pobyt ji znovu aktivuje, takže údaje nikdy neopustí pokoj.
- Přihlaste PMS nebo recepci k webhookům, abyste viděli aktivované, deaktivované a vypršelé linky.
Integrace s PMS
Příjezd a odjezd řídí pokoje.
- Vytvořte pro PMS klíč Reseller API a uložte jej do konfigurace PMS.
- Při příjezdu PMS volá action=enable_line a action=renew_line pro linku pokoje s ID požadavku; při odjezdu action=disable_line.
- Aplikace pro služby hostům (přivolání personálu, úklid, expresní odjezd, pokojová služba) a její propojení s back-office jsou součástí tarifu Enterprise a vymezují se společně s ubytováním.
Bezpečnostní hlediska
Udržte kanály uvnitř ubytování.
- Držte základ přehrávání a uzly v síti ubytování; nevystavujte internetu nic, co pokoje nepotřebují.
- Jedno připojení na pokoj, svázané se zařízením; podepsané odkazy vyprší, takže zkopírovaný odkaz přestane fungovat.
- Dvoufázové přihlášení do panelu; recepce dostane skupinu s omezenými oprávněními.
- Zapněte šifrovanou zálohu databáze; jsou v ní údaje pokojů.
Řešení potíží
Obvyklé první kontroly.
- Pokoj nemá televizi: zkontrolujte, že jeho linka je povolená a nevypršela, poté údaje a adresu zařízení.
- V pokoji chybí kanál: zkontrolujte bouquet balíčku kategorie pokoje.
- Televize se při výpadku internetu zastaví: zkontrolujte, že základ přehrávání a zdroje jsou interní adresy; externí feedy závisí na uplinku.
- Volání z PMS selhává: zkontrolujte klíč API, že zápisy jsou POST, a ID požadavku při opakování.