Deze gidsen koppelen de begrippen van een sector aan de objecten die het platform vandaag heeft (bouquets, lijnen, pakketten, partneraccounts, nodes, de API). Het zijn conceptuele toewijzingen, geen sectorspecifieke functies, en een partneraccount is een gedelegeerd account, geen geïsoleerde tenant.
Conceptuele toewijzing
Niets in het paneel heet een kamer of een verblijf. De tabel zegt welk object welke rol speelt; de hoofdstukken hieronder zetten ze in die volgorde op.
| In je sector | Op het platform | Waar in het paneel |
|---|---|---|
| Hoteloperator of erkende partner | Partneraccount (reseller): een gedelegeerd dashboard met credits, rechten en eigen lijnen | Users → een reseller toevoegen; Groups voor zijn rechten |
| Kanaalpakket | Bouquet: een benoemde set kanalen, films of series die een pakket toekent | Bouquets, vanuit Streams en Movies / Series |
| Kamer of apparaat | Lijn: één toegang met pakket, bouquets, vervaldatum, verbindingslimiet en uitvoer | Lijnen → toevoegen, of activeringscodes, of de Reseller-API |
| Informatievideo's van het hotel | VOD-catalogus: films en series met seizoenen en afleveringen, categorieën en metadata | Movies en Series, of de VOD-ingesttaak |
| Gelicentieerde televisiekanalen | Live kanaal: een stream met zijn bronnen, EPG en uitvoerformaten | Streams → een live stream toevoegen (bron-URL of RTMP-push) |
| Verblijfsduur | Vervaldatum van de lijn, verlengd door een pakket, een credit of de API | De vervaldatum van de lijn en de looptijd van het pakket |
| Eén node per gebouw of vleugel | Streamingnodes: edge-servers die vanuit het paneel worden geregistreerd, één per locatie of gebouw | Servers → een node toevoegen, geïnstalleerd via SSH |
Vereisten
Wat je moet hebben vóór de installatie.
- Een server op het netwerk van het hotel (Ubuntu 22.04 of 24.04), het installatieprogramma en een adres dat de apparaten op de kamers kunnen bereiken.
- De kanaalfeeds waarvoor het hotel de rechten heeft (pull-URL's of RTMP), de informatievideo's van het hotel en de apparaten op de kamers (Android TV-boxen, MAG- of Enigma2-boxen, smart-tv's met een player-app of een browser).
- Het vermogen van het PMS om bij check-in en check-out een HTTP-API aan te roepen, of een baliprocedure om dit in het paneel te doen.
Uitrol van de infrastructuur
De centrale server en een node per gebouw.
- Start het installatieprogramma op de centrale server; stel de playback base in op het interne adres van het hotel zodat de kamers op het lokale netwerk blijven.
- Voeg de kanaalfeeds toe onder Streams en de informatievideo's onder Movies; controleer ze in de webplayer.
- Registreer een node per vleugel of gebouw via Servers; het paneel installeert die via SSH en leidt de kamers van dat gebouw ernaartoe.
- Zet de licentiesleutel op de server; activering gebeurt ter plaatse en de dienst draait zonder de uplink.
Indeling van de content
Kanaalpakketten en hotelvideo's.
- Maak één bouquet per kanaalpakket (standaardkamers, suites, conferentie) van de kanalen van het hotel.
- Maak een bouquet met hotelvideo's (welkom, faciliteiten, veiligheid) en voeg die toe aan elk pakket.
- Maak één pakket per kamercategorie met de bouquets die het geeft en een looptijd van één dag: bij het inchecken wordt de lijn van de kamer per overnachting één keer verlengd (elke verlenging telt de looptijd van het pakket erbij op) en bij het uitchecken wordt die gedeactiveerd (hoofdstuk 8).
- Orden de kanalen en geef ze logo's zodat het menu op de televisie prettig leest.
Configuratie van partners (resellers)
Het hotel, of een operator die meerdere hotels beheert, als gedelegeerd account.
- Maak een groep met rechten beperkt tot lijnen (kamers) en zonder cataloguswijzigingen.
- Voeg de receptie van het hotel, of de operator, toe als reseller met die groep en de kamerpakketten.
- Een operator van meerdere hotels krijgt één reseller per hotel, elk met eigen kamers en credits.
Kamerconfiguratie (lijn)
Eén lijn per kamer, genoemd naar het nummer.
- Maak onder Lijnen één lijn per kamer aan met het kamernummer als naam en het pakket van de kamercategorie.
- Stel max. verbindingen in op 1 (één televisie) of op het aantal schermen op de kamer.
- Bind de lijn aan het adres van het apparaat op de kamer wanneer het netwerk de apparaten vaste adressen geeft.
- Configureer het apparaat (Xtream Codes API of M3U met de inloggegevens van de lijn, of het MAG- / Enigma2-portaal) één keer; de inloggegevens blijven bij de kamer.
Informatievideo's van het hotel
De eigen video's van het hotel on demand.
- Upload de welkoms- en informatievideo's als films, met de taalversies van het hotel als afzonderlijke items of audiosporen.
- Zet ze in de bouquet met hotelvideo's zodat elke kamercategorie ze ontvangt.
- Werk ze bij vanuit het paneel wanneer de informatie verandert; de kamers zien direct de nieuwe versie.
Gelicentieerde televisiekanalen
De kanalen van het hotel als live streams.
- Voeg elk gelicentieerd kanaal toe onder Streams met zijn feed; schakel timeshift of catch-up alleen in waar de licentie het toestaat.
- Voeg een EPG-bron toe zodat de gids op de televisie de programma's toont.
- Houd gebiedsgebonden kanalen in bouquets die alleen de juiste pakketten toekennen.
Check-in, check-out en vervaldatum
Het verblijf als geldigheid van de lijn.
- Schakel bij de check-in de lijn van de kamer in en verleng die voor de duur van het verblijf (het PMS via de API, of de balie in het paneel).
- Schakel bij de check-out de lijn uit; een nieuw verblijf schakelt hem weer in, zodat de inloggegevens de kamer nooit verlaten.
- Abonneer het PMS of de balie op de webhooks om ingeschakelde, uitgeschakelde en verlopen lijnen te zien.
Integratie met het PMS
Check-in en check-out sturen de kamers aan.
- Maak een Reseller-API-sleutel voor het PMS en bewaar die in de configuratie van het PMS.
- Bij de check-in roept het PMS action=enable_line en action=renew_line aan voor de lijn van de kamer met een request-id; bij de check-out action=disable_line.
- De gastenserviceapplicatie (personeel bellen, housekeeping, express check-out, roomservice) en de back-officekoppeling ervan maken deel uit van het Enterprise-abonnement en worden samen met het hotel afgebakend.
Beveiligingsoverwegingen
Houd de kanalen binnen het hotel.
- Houd de playback base en de nodes op het netwerk van het hotel; stel niets aan internet bloot wat de kamers niet nodig hebben.
- Eén verbinding per kamer, gebonden aan het apparaat; ondertekende links verlopen, dus een gekopieerde link werkt niet meer.
- Tweestapsverificatie voor het paneel; de balie krijgt een beperkte rechtengroep.
- Schakel de versleutelde databaseback-up in; de inloggegevens van de kamers staan daarin.
Probleemoplossing
De gebruikelijke eerste controles.
- Een kamer heeft geen televisie: controleer of de lijn is ingeschakeld en niet verlopen is, daarna de inloggegevens en het adres van het apparaat.
- Een kanaal ontbreekt op een kamer: controleer de bouquet van het pakket van de kamercategorie.
- De televisie stopt tijdens een internetstoring: controleer of de playback base en de bronnen interne adressen zijn; externe feeds hangen van de uplink af.
- De PMS-aanroep mislukt: controleer de API-sleutel, dat schrijfacties POST zijn en het request-id bij herhalingen.